Get output file

GET /api/v1/forward/batches/{batch_id}/output Returns an OSS pre-signed download URL for output.jsonl. The batch must be in a terminal state; otherwise the endpoint returns 400 batch_not_ready.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT>`

Path parameters

Parameter	Type	Required	Description
`batch_id`	string	Yes	Batch ID.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/batches/batch_completed001/output' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "url": "https://cloud-agents-storage.oss-cn-beijing.aliyuncs.com/files%2F<user_id>%2F<file_id>%2Fcontent?Expires=1783685162&OSSAccessKeyId=<ak>&Signature=<sig>&response-content-disposition=attachment%3B%20filename%3Dbatch-batch_completed001-output.jsonl",
  "expires_at": "2026-07-10T12:06:02Z"
}

Response fields

Field	Type	Description
`url`	string	OSS pre-signed download URL containing `Expires`, `OSSAccessKeyId`, `Signature`, and `response-content-disposition`. The download filename is `batch-<batch_id>-output.jsonl`.
`expires_at`	string	Link expiration time, RFC 3339. The download must complete before this time.

Error codes

HTTP	Type	Code	Trigger
400	`invalid_request_error`	`batch_not_ready`	Batch is not in a terminal state.
404	`not_found_error`	`batch_not_found`	Batch does not exist, belongs to another user, or output file has not been generated.
410	`not_found_error`	`file_expired`	The output file passed its 30-day retention and was purged.
401	`authentication_error`	`authentication_required`	PAT is invalid or expired.

Notes

Output files are retained for 30 days. After retention, the endpoint returns 410 file_expired.
The download filename is batch-<batch_id>-output.jsonl.
Failed-line results are in error.jsonl. Retrieve it via error_file_id from the batch detail.

First steps

Define your agent

Configure agent environment

Delegate work to your agent

Manage agent context

Best Practices

API reference

Get output file

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

Get a batch

List batches

​Headers

​Path parameters

​Example request

​Example response

​Response fields

​Error codes

​Notes

​Related

Get a batch

List batches

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

Related