Skip to main content
GET
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

string
required
The generationId from Create Try-On.

Response

string
required
The generation ID.
string
required
One of: PENDING, PROCESSING, COMPLETED, FAILED.
string
Temporary URL to the result image. Only present when status is COMPLETED.
string
Human-readable error description. Only present when status is FAILED.
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.
string
required
ISO 8601 timestamp.
string
required
ISO 8601 timestamp of the last status change.

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.