get_job
Check a job's status and Credits usage by ID without submitting work or charging Credits. Use it to confirm completion and retrieve output such as file URLs and sizes.
Instructions
Read job.status and Credits usage using its id. Pending/processing means the job is still running. Completed jobs include the original response in output. For YouTube downloads, output.results[0] contains file_url and file_size in customer storage. Private files require that storage’s access credentials; MCP does not publish them. JSON results expire after 24 hours; media retention follows the customer storage settings. Does not submit work or charge Credits. The API Key must belong to the job’s account and grant its source.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "get_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job ID returned by a previous asynchronous query or batch item. | |
| response_format | No | Agent-readable presentation. MCP defaults to Markdown; json returns the original JSON text, text returns indented fields. Structured fields remain available. Does not change billing or the stored job. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | Job status and metadata. Read status before using output. | |
| code | No | Machine-readable error code when the operation fails. | |
| chunk | No | A substring of the selected document. Concatenate all chunks before parsing JSON or displaying the full document. | |
| usage | No | Billing information returned by the API. | |
| detail | No | Additional problem detail returned by the API. | |
| offset | No | Start position in UTF-16 code units. | |
| output | No | Original response for a completed job; download results contain the customer-storage upload manifest. | |
| message | No | Error, delivery, or continuation instructions. | |
| encoding | No | How to read the assembled chunks. Parse JSON only for json. | |
| result_id | No | Temporary result identifier. Read subsequent chunks with get_result and the same API Key. | |
| expires_at | No | UTC expiry of the temporary result. | |
| request_id | No | FlashData request identifier for support and tracing. | |
| http_status | No | Upstream HTTP status, when an upstream request was made. | |
| next_offset | No | Next UTF-16 position; null when the result is complete. | |
| total_characters | No |