Get job result

GET

agents

jobs

{job_id}

result

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/result' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

{
  "job_id": "job_1779300000000000000",
  "status": "completed",
  "output": {
    "summary": "3 pending transactions above the threshold look suspicious and should be reviewed."
  },
  "final_message": "3 pending transactions above the threshold look suspicious and should be reviewed.",
  "last_error": "",
  "plan_run_id": "pr_1779300000000000000",
  "progress": {
    "total": 2,
    "completed": 2,
    "running": 0,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "completed",
      "task_id": "tsk_1779300000000000200",
      "summary": "Step completed.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:20Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:20Z",
  "completed_at": "2026-09-16T05:10:20Z",
  "failed_at": null,
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

Agent Jobs API is currently in beta.

Use this endpoint after an agent job completes or fails. You can call it earlier, but output, final_message, completed_at, and failed_at are fully populated only in a terminal state. For in-progress polling, use Get job status. To receive this payload automatically, set config.callbacks when you create the job.

Add ?view=debug (or view=verbose, verbose=1) to include a debug object with the raw plan steps and reasoning trail.

Authorization

Blnk Cloud APIs support any one of the following authentication methods. All of them work with your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.

Bearer token
X-Blnk-Key header
X-API-Key header

Pass Authorization: Bearer CLOUD_API_KEY or Authorization: Bearer OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Pass X-Blnk-Key: CLOUD_API_KEY or X-Blnk-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Pass X-API-Key: CLOUD_API_KEY or X-API-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Path

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/result' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

string

required

Job whose result you want (job_...). Use the job_id returned by Create agent job.

string

Set to debug or verbose to add a debug object with the raw plan steps and reasoning trail. Leave unset for the compact payload.

string

Optional Core instance (instance_...). When present, Cloud checks that the instance belongs to your organization. The job already stores its instance from create.

Response

{
  "job_id": "job_1779300000000000000",
  "status": "completed",
  "output": {
    "summary": "3 pending transactions above the threshold look suspicious and should be reviewed."
  },
  "final_message": "3 pending transactions above the threshold look suspicious and should be reviewed.",
  "last_error": "",
  "plan_run_id": "pr_1779300000000000000",
  "progress": {
    "total": 2,
    "completed": 2,
    "running": 0,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "completed",
      "task_id": "tsk_1779300000000000200",
      "summary": "Step completed.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:20Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:20Z",
  "completed_at": "2026-09-16T05:10:20Z",
  "failed_at": null,
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

string

Job you requested (job_...). Same value you sent in the path.

string

Where the job is right now. Read output and final_message when this is completed. Read last_error when this is failed. You can call this endpoint earlier, but those fields fill in only after the job finishes.

object

Structured result of the finished plan. The keys depend on the steps that ran. Often includes a summary string. Empty or partial until status is completed.

string

Plain-language summary of the result. Use this for UI copy. The same text is often also in output.summary.

string

Why the job failed. Empty on success. Filled when status is failed.

string

Plan that produced this result (pr_...). Empty if planning never finished.

object

How many plan steps ended in each state: total, completed, running, pending, failed, waiting_approval. Same shape as Get job status.

object

First compact step with status failed. null when the job completed without a failed step. Same shape as one item in sub_tasks on Get job status.

array

Compact plan steps, oldest first. Same fields as sub_tasks on Get job status.

array

Compact planner and execution notes (id, kind, title, status, summary). Empty if the planner wrote none.

timestamp

When Cloud accepted the job, in UTC ISO 8601.

timestamp

When the job last changed, in UTC ISO 8601.

timestamp

When the job reached completed, in UTC ISO 8601. null until then.

timestamp

When the job reached failed, in UTC ISO 8601. null unless status is failed.

object

Relative paths for status, result, and control on this job. Prefix them with https://api.cloud.blnkfinance.com.

object

Raw sub_tasks and reasoning_trail. Present only when you send view=debug (or verbose=1). Omit it in production clients.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/result' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

{
  "job_id": "job_1779300000000000000",
  "status": "completed",
  "output": {
    "summary": "3 pending transactions above the threshold look suspicious and should be reviewed."
  },
  "final_message": "3 pending transactions above the threshold look suspicious and should be reviewed.",
  "last_error": "",
  "plan_run_id": "pr_1779300000000000000",
  "progress": {
    "total": 2,
    "completed": 2,
    "running": 0,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "completed",
      "task_id": "tsk_1779300000000000200",
      "summary": "Step completed.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:20Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:20Z",
  "completed_at": "2026-09-16T05:10:20Z",
  "failed_at": null,
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

Start Here

Deployments

Proxy & data

Data lake

AI integrations

Audit

Alerts

Billing

Authorization

Path

Response

Need help?

​Authorization

​Path

​Response

​Need help?

Authorization

Path

Response

Need help?