Skip to main content
GET
Where an async job stands; once finished, the result or a stable error code.

Authentication

Requires the X-Agent-ID header with your wallet address. You can only read jobs you own.

Path parameters

string
required
Request ID returned by a tool call (e.g., req_xyz789)

Response

string
Job ID
string
pending, processing, completed, or failed
string
Tool called
object
Job result (when completed)
string
Message (when failed), with a (ref: <id>) id for support.
string
Stable code (when failed). See Error codes.
string
payment, validation, upstream, or internal (when failed).
number
HTTP-like status code (when failed).
string
When the job was created
string
When the job was last updated
string
Whether the paid action ran: pending, then completed or failed. With receipt_id; independent of settlement_status.
object | null
The executing vendor’s own ref for the action and its kind, or null when no vendor returned one.
object
Email jobs only: from, to, subject, status, opens, clicks.

How results are delivered

Most paid tools return 202 with a request_id; the result appears here when the job finishes. A tool that answers in the same response returns 200; its own page says so. The SDKs wait for you. Without an SDK, poll with a sub-second first check and back off; there is no completion webhook. For wait: false, use the SDK’s waitForResult(requestId) later. Enrichment and web reads take seconds; research and builds take minutes.

Error codes

When status is failed, error_code is one of these stable values. The error string may change. Jobs are retained for 30 days.