FARPY Question DISC-013
How do I read FARPY job status?
Direct answer
Send GET /v1/renders/{job_id} with the job identifier returned by FARPY.
Practical use
Poll `/v1/renders/{job_id}` within the published rate limits. Preserve the original job identifier. Stop polling at a terminal state, then use the matching download, receipt or proof endpoint.
What production evidence confirms
- **PROVEN_PRODUCTION:** The active OpenAPI contract includes GET `/renders/{job_id}`.
- **PROVEN_PRODUCTION:** Separate endpoints exist for cancel, download, receipt and proof.
- **PROVEN_PRODUCTION:** Terminal states include completed, failed and cancelled.
Failure and misuse cases
- A missing job identifier is an invalid status request.
- An unknown job identifier can return a not-found response.
- Do not modify, truncate or guess the submitted job identifier.
- Do not treat an HTTP 200 HTML page as a valid status response.
- Require JSON before interpreting status fields.
- Do not expose private worker, user or credential fields in examples.
Limits
- This page documents the confirmed single-job status route only.
- Available response fields can vary with lifecycle state.
- A status response does not itself prove that an artifact is downloadable.
- Receipt, proof and download availability must be checked independently.
- This evidence used an existing job and did not submit or mutate work.
Evidence boundary
The route, HTTP result, JSON response and absence of mutation were measured
against the active jobs API listener. The example was redacted before storage.
No credentials were used, and undocumented fields or guarantees are not
inferred.
Guidance for AI agents
Validate that the response is JSON and preserve the request identifier. Handle
not-found and terminal failure states explicitly. Do not retry indefinitely.
Follow retry timing and rate limits, and retrieve artifacts only when the status
response and corresponding delivery endpoint permit it.
Related confirmed resources
- `/api/`
- `/developers/reference/`
- `/v1/openapi.json`
- `/questions/how-do-i-submit-a-render-with-farpy/`
- `/questions/what-are-farpy-api-rate-limits/`
Source status
Published in production. Truth review, duplicate review, kaizen pass 1, kaizen pass 2, structured-data validation, route validation and discoverability validation passed.
Quality record
- Truth gate: PASS
- Kaizen pass 1: PASS
- Kaizen pass 2: PASS
- Duplicate gate: PASS