--- title: "Get prediction status" method: GET path: "/v1/status/{id}" tags: ["Predictions"] --- # Get prediction status `GET /v1/status/{id}` Poll for the status of a specific prediction using its ID. Use this endpoint to track prediction progress and retrieve results. **Status States:** - `starting` - Prediction is being initialized - `in_queue` - Prediction is waiting to be processed - `processing` - Model is actively generating your result - `completed` - Generation finished successfully, output available - `failed` - Generation failed, check error details **Output Availability:** - **CDN URLs** (default): Available for 72 hours after completion - **Base64 outputs** (when `return_base64: true`): Available for 60 minutes after completion ## Path parameters - `id` string, required ## Response `200` Prediction status retrieved successfully - StatusResponse - `id` string, required — The unique prediction ID - `status` 'starting' | 'in_queue' | 'processing' | 'completed' | 'failed' | 'canceled' | 'time_out', required — Current status of the prediction - `output` union — Generated media - for images, outputs are either CDN URLs or base64 (when requested); for videos, outputs are CDN MP4 URLs - string[] — Array of CDN URLs to generated media (images or videos) - string[] — Array of base64-encoded images with proper data URI prefix - `error` object, nullable, required — Structured error object with name and message fields - `name` 'ImageLoadError' | 'ContentModerationError' | 'PoseError' | 'InputValidationError' | 'PipelineError' | 'ThirdPartyError' | '3rdPartyProviderError' | 'InternalServerError', required — Error type/category with troubleshooting guidance: **ImageLoadError** - Unable to load image from provided inputs - *Cause*: Pipeline cannot load product image, model image, garment image, or reference image - *Solution*: For URLs - ensure public accessibility and correct Content-Type headers. For Base64 - include proper data:image/format;base64 prefix **ContentModerationError** - Prohibited content detected - *Cause*: Content moderation flagged product, garment, or model image. More sensitive when model_image contains an actual person (virtual try-on mode) - *Solution*: For try-on models - adjust moderation_level to 'permissive' or 'none' if appropriate. For product-to-model - explicit or inappropriate imagery is prohibited, particularly with real people. For intimate apparel (lingerie/swimwear), use FASHN Virtual Try-On endpoint with full moderation control. Product generation without model_image operates under more permissive policies. Contact support@fashn.ai with prediction ID if content was incorrectly flagged **PoseError** - Unable to detect body pose (try-on models only) - *Cause*: Body pose not detectable in model or garment image - *Solution*: Improve image quality following model photo guidelines **InputValidationError** - Invalid parameter combination (reframe only) - *Cause*: Missing required parameters or invalid values for selected mode - *Solution*: Ensure target_aspect_ratio is provided when mode is 'aspect_ratio'. Check aspect ratio values are from supported list **PipelineError** - Unexpected pipeline execution error - *Cause*: Internal processing failure - *Solution*: Retry request (no charge for failures). Contact support@fashn.ai with prediction ID if persists **ThirdPartyError** - Third-party processor failure - *Cause*: External service restrictions (content/prompt limitations) - *Model-specific solutions*: - *Try-on*: Modify image inputs for captioning restrictions - *Product-to-model*: Try modifying image inputs, most likely caused by content restrictions in image captioning - *Model-swap*: Try different inputs or disable prompt enhancement - *Background-change*: Modify image inputs or background prompt - *Reframe*: Try different image inputs for captioning restrictions - Contact support@fashn.ai with prediction ID if persists **3rdPartyProviderError** - Third-party provider failure (fallback error type) - *Cause*: External provider error without specific classification - *Solution*: Retry request. Contact support@fashn.ai with prediction ID if persists **InternalServerError** - General server error (fallback error type) - *Cause*: Unexpected server-side failure - *Solution*: Retry request. Contact support@fashn.ai with prediction ID if persists - `message` string, required — Detailed error message explaining the specific failure ## Other responses - `401` — Unauthorized - Invalid or missing API key - `404` — Prediction not found - `429` — Rate limit exceeded - `500` — Internal server error ## Changes - **2026-03-30** `ff222a7f898d` — 1 info - removed the `LoRALoadError` enum value from the `error/oneOf[subschema #1]/name` response property for the response status `200` - **2025-08-18** `4173af13823d` — 2 info - response property `output` list-of-types was narrowed by removing types `object` from media type `application/json` of response `200` - removed `subschema #2` from the `error` response property `oneOf` list for the response status `200` - **2025-08-18** `661a7261f6b6` — 2 breaking - response property `output` list-of-types was widened by adding types `object` to media type `application/json` of response `200` - added `subschema #2` to the `error` response property `oneOf` list for the response status `200` - **2025-08-18** `4173af13823d` — 2 info - response property `output` list-of-types was narrowed by removing types `object` from media type `application/json` of response `200` - removed `subschema #2` from the `error` response property `oneOf` list for the response status `200` [Change history](https://skmtc.dev/fashn-ai/apis/fashn-api/changes/v1/status/:id/get.md) --- [API](https://skmtc.dev/fashn-ai/apis/fashn-api.md) · [All operations](https://skmtc.dev/fashn-ai/apis/fashn-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fashn-ai/fashn-api/revisions/bff12bc9de53/schema)