List recent verification waits for an inbox

Returns the inbox's verification waits, most recent first, across every status (pending, resolved, expired, canceled).

Endpoint

GET https://api.dairo.app/v1/inboxes/{inbox}/verification-waits

Returns the inbox's verification waits, most recent first, across every status (pending, resolved, expired, canceled). Use limit (1–100, default 50) to cap the result; the endpoint returns a single page with no cursor, so it is a snapshot of recent activity rather than a full-history walk. Each wait carries its status, the instruction it was registered with, and — once resolved — the extracted result, the resolving from address, and messageId. The {inbox} segment accepts an inbox UUID or full address such as agent@dairo.app; an unknown or non-owned inbox returns 404.

Scope: inboxes:read. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL

curl "https://api.dairo.app/v1/inboxes/support/verification-waits" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Path parameters

Name	Type	Required	Description
`inbox`	string	yes	Inbox UUID or full address (e.g. `agent@dairo.app`).

Query parameters

Name	Type	Required	Description
`limit`	integer	no	Max waits to return (1..=100). (minimum 1, maximum 100, default `50`)

Response

200 Success. Body: application/json, VerificationWaitListResponse.

Field	Type	Required
`object`	`"list"`	yes
`data`	array of VerificationWait	yes
`pagination`	Pagination	yes

200

{
  "object": "list",
  "data": [
    {
      "waitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "inboxId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "pending",
      "fromHint": null,
      "instruction": null,
      "result": null,
      "from": null,
      "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "idempotencyKey": null,
      "expiresAt": "2026-10-19T09:30:00Z",
      "createdAt": "2026-10-19T09:30:00Z",
      "resolvedAt": "2026-10-19T09:30:00Z",
      "expiredAt": "2026-10-19T09:30:00Z"
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

Status	Meaning
`400`	The request is malformed or a value is invalid (`invalid_request`, `invalid_domain`, `idempotency_key_mismatch`).
`401`	The API key is missing or invalid.
`403`	The key lacks the scope this endpoint needs (`scope_missing`) or may not do this (`not_permitted`).
`404`	No such resource in this account (`resource_not_found`).
`409`	The resource already exists or its state does not allow this (`duplicate_resource` or a condition-specific code).
`422`	The request is well-formed but a field failed validation (`validation_failed`).
`429`	Rate limit, plan limit, budget or spend cap reached (`rate_limited`, `plan_limit_reached`, `budget_exceeded`, `spend_cap_reached`).
`500`	An unexpected error; retry with backoff, then contact support (`internal_error`).