> ## Documentation Index > Fetch the complete documentation index at: https://docs.bland.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Pathway Translation Run > Poll the status and result of a translation job. ### Overview Returns the current state of a job started with [Start Pathway Translation](https://docs.bland.ai/api-v2/post/agents-migrate-translations.md). While the job runs, the record carries status and progress counters only; the full result appears once the status is terminal (`COMPLETE`, `FAILED`, or `CANCELLED`). A run that has not finished after 11 hours is marked `FAILED` with `TRANSLATION_TIMED_OUT` the next time it is read. ### Headers **authorization** `string` *required* Your API key for authentication. ### Path Parameters **run\_id** `string` *required* The run's unique identifier. Returns `400 INVALID_RUN_ID` if it is not a UUID and `404 TRANSLATION_RUN_NOT_FOUND` if no run with that ID exists in your organization. ### Response **data.run** `object` The run record. **run object** **id** `string` Unique identifier for the run. **status** `string` One of `PENDING` (queued), `RUNNING` (pathways being processed), `FINALIZING` (all pathways done, agent being created; can no longer be cancelled), `COMPLETE`, `FAILED`, `CANCELLED`. The last three are terminal. **total\_pathways** `integer` Number of pathways in the job. **completed\_pathways** `integer` Pathways processed so far. **result** `object | null` `null` until the run is terminal. On `COMPLETE`, see the result object below. Also `null` on `FAILED` or `CANCELLED` unless a result had already been written. **error\_code** `string | null` Set on `FAILED` or `CANCELLED`, for example `TRANSLATION_CANCELLED`, `TRANSLATION_TIMED_OUT`, or `TRANSLATION_START_FAILED`. `null` otherwise. **error\_message** `string | null` Human-readable failure reason, safe to show to users. `null` unless `error_code` is set. **created\_at** `string` ISO 8601 timestamp of when the run was created. **completed\_at** `string | null` ISO 8601 timestamp of when the run reached a terminal state, or `null` while it is still active. **data.run.result** `object | null` The terminal result. Which of `scenarios` or `agent` and `version` is present depends on the job's `create` flag. **result object** **per\_pathway** `array` One entry per pathway, in job order. Each has `pathway_id`, `mode` (`one_to_one` or `translate`), `pathway_name`, `scenario_names` (the scenarios produced from it), `warnings` (strings), and, for `translate` entries only, `report` (the planner's accounting: `architectureSummary`, `dispositions`, `droppedOrApproximated`, `openQuestions`). **scenarios** `array` Present when the job was started with `create: false`. The combined scenario nodes from every pathway, each with `id`, `type` (`scenario` or `complex-scenario`), `position`, and `data`, ready to add to an existing agent with [Create Agent Version](https://docs.bland.ai/api-v2/post/agents-id-versions.md). **warnings** `array` All pathways' warnings combined, plus job-level notes such as a global prompt that was not carried over. **lint** `object` Structural checks on the combined result: `errors` and `warnings` (arrays of strings). **agent** `object` Present when the job created an agent. The agent record: `id`, `org_id`, `name`, `created_by` (`string | null`), `created_at`, `updated_at`, `deleted_at` (`null`). **version** `object` Present when the job created an agent. Its first version: `id`, `org_id`, `agent_id`, `branch_id` (`null`), `snapshot` (the full agent configuration, abbreviated in the example below), `name`, `created_via` (`manual`), `revision` (`0`), `created_by`, `created_at`. **errors** `null | array` `null` on success, or a list of error objects if the request failed. ```json Response theme={null} { "data": { "run": { "id": "182405af-c7b3-4640-adea-42f3f91d70dd", "status": "COMPLETE", "total_pathways": 2, "completed_pathways": 2, "result": { "per_pathway": [ { "pathway_id": "8c2c2ec5-d8d5-42a0-9b38-0bfb7d2b2e65", "mode": "translate", "pathway_name": "Order status", "scenario_names": ["Look up order"], "warnings": [], "report": { "architectureSummary": "Three lookup nodes merged into one scenario with a webhook tool.", "dispositions": [ { "nodeIds": ["4ee8cecb-df73-4883-a0c8-965bfb9e0077", "2c8026a9-5dc3-4e3e-83e5-b306e4d4369b"], "disposition": "Became scenario \"Look up order\"", "rationale": "Collect-then-fetch sequence with no branching." } ], "droppedOrApproximated": [], "openQuestions": [] } }, { "pathway_id": "7aa67804-b77a-414c-86de-06497b7dc2c5", "mode": "one_to_one", "pathway_name": "Returns", "scenario_names": ["Returns"], "warnings": [] } ], "warnings": [], "lint": { "errors": [], "warnings": [] }, "agent": { "id": "09ffd40f-cf55-448e-ab85-ad5c2cff650b", "org_id": "45794f66-94ca-44a2-9248-202c5ff22717", "name": "Migrated pathways", "created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a", "created_at": "2026-09-10T20:14:52.301Z", "updated_at": "2026-09-10T20:14:52.301Z", "deleted_at": null }, "version": { "id": "bc44cc7d-d822-4d0b-9661-b7916c4277a5", "org_id": "45794f66-94ca-44a2-9248-202c5ff22717", "agent_id": "09ffd40f-cf55-448e-ab85-ad5c2cff650b", "branch_id": null, "snapshot": { "behavior": { "nodes": [ { "id": "inbound", "type": "inbound", "position": { "x": 360, "y": -180 }, "data": { "number": "" } }, { "id": "agent", "type": "agent", "position": { "x": 192, "y": 0 }, "data": { "prompt": "Greet the caller and find out what they need.\n\n## Routing\n\nAfter each user turn, enter the scenario that matches where the conversation is now. The scenarios you can enter:\n\n- \"Look up order\": the caller wants the status of an order\n- \"Returns\": the caller wants to return an item", "loopWhile": "", "variables": [] } }, { "id": "a732a5dd-5430-460e-8fab-cf5576a34b41", "type": "scenario", "position": { "x": -190, "y": 260 }, "data": { "name": "Look up order", "rule": "Ask for the order number, look it up, and read back the shipping status.", "target": { "kind": "dialogue", "label": "Look up order" }, "loopWhile": "", "variables": [], "entry": { "mode": "llm", "label": "Order status", "description": "The caller wants the status of an order", "alwaysPick": false, "conditions": [] } } }, { "id": "bb0041fb-8077-41eb-aec9-57c1d477a70d", "type": "complex-scenario", "position": { "x": 190, "y": 260 }, "data": { "name": "Returns", "rule": "The caller wants to return an item", "target": { "kind": "dialogue", "label": "Returns" }, "entry": { "mode": "llm", "label": "Returns", "description": "The caller wants to return an item", "alwaysPick": false, "conditions": [] }, "flow": { "nodes": [ { "id": "start", "type": "start", "position": { "x": 0, "y": 0 }, "data": {} }, { "id": "4fce61ee-3bfa-4def-bcad-7198b04bf853", "type": "prompt", "position": { "x": 0, "y": 160 }, "data": { "name": "Reason for return", "prompt": "Ask why the caller is returning the item.", "useStaticText": false, "loopWhile": "", "variables": [], "useAudioExtraction": false, "ignorePreviousExtractions": false, "settings": {} } }, { "id": "end", "type": "end", "position": { "x": 0, "y": 320 }, "data": {} } ], "edges": [ { "id": "e-start-reason", "source": "start", "target": "4fce61ee-3bfa-4def-bcad-7198b04bf853" }, { "id": "e-reason-end", "source": "4fce61ee-3bfa-4def-bcad-7198b04bf853", "target": "end" } ] } } } ], "edges": [ { "id": "e-inbound-agent", "source": "inbound", "target": "agent" }, { "id": "e-agent-lookup", "source": "agent", "target": "a732a5dd-5430-460e-8fab-cf5576a34b41", "data": { "mode": "llm", "label": "Order status", "description": "The caller wants the status of an order", "alwaysPick": false, "conditions": [] } }, { "id": "e-agent-returns", "source": "agent", "target": "bb0041fb-8077-41eb-aec9-57c1d477a70d", "data": { "mode": "llm", "label": "Returns", "description": "The caller wants to return an item", "alwaysPick": false, "conditions": [] } } ] }, "settings": { "displayName": "Migrated pathways", "systemPrompt": "You help customers of Acme Outdoor.", "voice": "", "languages": ["english"], "enableMemory": false, "interruptionSensitivity": 350, "backgroundNoise": "off" }, "contact": { "inboundNumbers": [] } }, "name": "Migrated from 2 pathway(s)", "created_via": "manual", "revision": 0, "created_by": "bd8ae00b-c51d-4364-b1b3-245ad579c44a", "created_at": "2026-09-10T20:14:52.301Z" } }, "error_code": null, "error_message": null, "created_at": "2026-09-10T20:01:12.530Z", "completed_at": "2026-09-10T20:14:52.418Z" } }, "errors": null } ``` ```json In Progress theme={null} { "data": { "run": { "id": "182405af-c7b3-4640-adea-42f3f91d70dd", "status": "RUNNING", "total_pathways": 2, "completed_pathways": 1, "result": null, "error_code": null, "error_message": null, "created_at": "2026-09-10T20:01:12.530Z", "completed_at": null } }, "errors": null } ``` ```json Not Found theme={null} { "data": null, "errors": [ { "error": "TRANSLATION_RUN_NOT_FOUND", "message": "no translation run with that id" } ] } ``` *** Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.