Skip to main content
GET
/
tryon
/
v1
/
generations
/
{id}
curl "https://api.genlook.app/tryon/v1/generations/cm8gen456xyz" \
  -H "x-api-key: gk_your_api_key"

{
  "generationId": "cm8gen456xyz",
  "status": "PENDING",
  "createdAt": "2026-03-30T10:00:00.000Z",
  "updatedAt": "2026-03-30T10:00:00.000Z"
}
Returns the current status of a generation. When COMPLETED, the response includes a temporary URL to the result image. Poll every 2s until status is COMPLETED or FAILED.

​
Path Parameters

​
id
string
required
The generationId from Create Try-On.
curl "https://api.genlook.app/tryon/v1/generations/cm8gen456xyz" \
  -H "x-api-key: gk_your_api_key"

​
Response

​
generationId
string
required
The generation ID.
​
status
string
required
One of: PENDING, PROCESSING, COMPLETED, FAILED.
​
resultImageUrl
string
Temporary URL to the result image. Only present when status is COMPLETED.
​
errorMessage
string
Human-readable error description. Only present when status is FAILED.
​
errorCode
string
Stable error code (e.g. PRODUCT_IMAGE_FETCH_FAILED) when the failure was raised as a typed error. Use this — not the message text — to switch on failure type. Absent for untyped/internal failures. See the Errors catalog.
​
createdAt
string
required
ISO 8601 timestamp.
​
updatedAt
string
required
ISO 8601 timestamp of the last status change.
{
  "generationId": "cm8gen456xyz",
  "status": "PENDING",
  "createdAt": "2026-03-30T10:00:00.000Z",
  "updatedAt": "2026-03-30T10:00:00.000Z"
}

​
Common failure causes

A FAILED status usually means one of:
  • The product image URL returned an error or could not be reached.
  • The customer or product image was rejected during pre-processing.
  • The AI pipeline returned an unrecoverable error.
When the failure is typed, errorCode is a stable enum value from the Errors catalog — switch on this rather than the human-readable errorMessage. Most failures are safe to retry.