Download Results

Retrieve enhanced images for a completed job.

GET/api/v1/downloads/{jobId}

Get download URLs for all approved images in a completed job.

Path Parameters

Name	Type	Required	Description
`jobId`	`string`	Required	The unique job identifier

Request Example

curl https://www.quickhome.ai/api/v1/downloads/job_abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK

{
  "jobId": "job_abc123xyz",
  "address": "266 Dana Point Ave, Ventura, CA 93004, USA",
  "imageCount": 2,
  "images": [
    {
      "id": "asset_xyz1",
      "fileName": "hero_enhanced.jpg",
      "type": "generated_exterior",
      "url": "https://yourdomain.supabase.co/storage/v1/object/sign/generated-assets/..."
    },
    {
      "id": "asset_xyz2",
      "fileName": "closeup_enhanced.jpg",
      "type": "generated_exterior",
      "url": "https://yourdomain.supabase.co/storage/v1/object/sign/generated-assets/..."
    }
  ]
}

Response Fields

Name	Type	Required	Description
`jobId`	`string`	Required	The job identifier
`address`	`string`	Required	Property address
`imageCount`	`number`	Required	Total number of images available
`images`	`array`	Required	Array of image objects with download URLs

Download URL Details

• URL expiration: Download URLs are valid for 24 hours from generation
• Re-requesting URLs: Call this endpoint again to get fresh URLs if they expire
• Job retention: Completed jobs and images are stored for 7 days
• Download limit: No limit on how many times you can download images

Error Responses

400 Job Not Ready

400 Error

{
  "error": "Job not ready for download",
  "status": "processing",
  "message": "Job must be completed before downloading results"
}

404 Job Not Found

404 Error

{
  "error": "Job not found",
  "message": "Job may have been deleted or expired (jobs are retained for 7 days)"
}