Skip to main content
GET
/
v1
/
images
/
{imageId}
Get image status
curl --request GET \
  --url https://api.fotolabs.co/v1/images/{imageId} \
  --header 'Authorization: Bearer <token>'
{
  "imageId": "f3e088d1-33a5-4227-a2f6-c4f75617f847",
  "status": "pending",
  "resultImageUrl": null,
  "originalImageUrl": "https://d1i1ga8jkrbik1.cloudfront.net/...",
  "errorMessage": null,
  "createdAt": "2026-05-09T18:00:48.421Z",
  "updatedAt": "2026-05-09T18:00:48.421Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.fotolabs.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key with fl_ prefix, issued from the Fotolabs dashboard

Path Parameters

​
imageId
string<uuid>
required

Response

Image record.

​
imageId
string<uuid>
required
​
status
enum<string>
required
Available options:
pending,
processing,
completed,
failed
​
resultImageUrl
string<uri> | null
required

CloudFront URL of the processed JPEG. Non-null only when status is completed.

​
originalImageUrl
string<uri>
required

CloudFront URL of the original uploaded image.

​
errorMessage
string | null
required

Human-readable error. Non-null only when status is failed.

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required