Skip to main content
GET
/
v1
/
pathway
/
generate
/
status
/
{job_id}
Get Pathway Generation Status
curl --request GET \
  --url https://api.bland.ai/v1/pathway/generate/status/{job_id} \
  --header 'authorization: <authorization>'
{
  "data": {
    "ready": false
  },
  "errors": null
}

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

job_id
string
required
The jobId returned by POST /v1/pathway/generate.

How polling works

  • The first status request can return ready: false while the server begins processing.
  • Continue polling until data.ready is true.
  • On success, the response includes pathway_id.
  • On failure, the response includes error.

Response

data
object
Generation state object.
data.ready
boolean
false while generation is still in progress, true when processing is complete.
data.pathway_id
string
Present when generation succeeds and ready is true.
data.error
string
Present when generation fails and ready is true.
errors
null | array
null on success responses, or a list of errors for invalid/unauthorized requests.
{
  "data": {
    "ready": false
  },
  "errors": null
}