Get Job Results
Returns the results of a completed retrieval job, including signed download URLs for each artifact. URLs are pre-signed and time-limited.
GET /v1/retrieval/jobs/:jobId/results
Path Parameters
| Parameter | Type | Description |
|---|
jobId | string | The retrieval job ID |
Example Request
curl https://api.docyard.io/v1/retrieval/jobs/ret_01HQ4A.../results \
-H "Authorization: Bearer dk_live_a1b2c3d4..."
Response
{
"status": "COMPLETED",
"totalCount": 3,
"items": [
{
"artifactId": "art_01HQ3M...",
"filename": "declaration-page-2025.pdf",
"url": "https://storage.docyard.io/signed/docks/dock_01HQ3K.../art_01HQ3M...?token=eyJ...",
"expiresAt": "2025-01-22T13:00:00.000Z"
},
{
"artifactId": "art_01HQ3N...",
"filename": "coi-renewal-q4.pdf",
"url": "https://storage.docyard.io/signed/docks/dock_01HQ3K.../art_01HQ3N...?token=eyJ...",
"expiresAt": "2025-01-22T13:00:00.000Z"
},
{
"artifactId": "art_01HQ3P...",
"filename": "endorsement-addendum.pdf",
"url": "https://storage.docyard.io/signed/docks/dock_01HQ3K.../art_01HQ3P...?token=eyJ...",
"expiresAt": "2025-01-22T13:00:00.000Z"
}
]
}
Error Handling
| Status | Condition |
|---|
400 | Job is not yet completed (status is PENDING or PROCESSING) |
401 | Missing or invalid API key |
404 | Job not found |
Signed download URLs expire 1 hour after generation. Result sets expire 24 hours after job completion. After expiration, you must create a new retrieval job to generate fresh URLs.
