Retrieve a manual handoff | Collate API Documentation

Returns a durable manual handoff without runtime secrets.

Use this endpoint to inspect handoff state, result, and the operator-reported completion claim.

Authorization truth remains on the PriorAuthorization response.

Returns

Returns the ManualHandoff.

AuthorizationBearer

API key passed as Authorization: Bearer <API_KEY>.

authorization_idstringRequired

Authorization ID returned by POST /v1/prior-authorizations.

handoff_idstringRequired

Manual handoff ID returned by POST /manual-handoffs.

Successful Response

idstring

versioninteger

priorAuthorizationIdstring

stateenum

Allowed values:

createdAtdatetime

resultenum or null

accessAvailablebooleanDefaults to false

finalSubmitCapablebooleanDefaults to false

activatedAtdatetime or null

closedAtdatetime or null

messagestring or null

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

413

Content Too Large Error

422

Unprocessable Entity Error

500

Internal Server Error

503

Service Unavailable Error

1	{
2	"id": "string",
3	"version": 1,
4	"priorAuthorizationId": "string",
5	"state": "offered",
6	"createdAt": "2024-01-15T09:30:00Z",
7	"result": "completed_reported",
8	"accessAvailable": false,
9	"finalSubmitCapable": false,
10	"activatedAt": "2024-01-15T09:30:00Z",
11	"closedAt": "2024-01-15T09:30:00Z",
12	"message": "string"
13	}

$	curl https://api.sandbox.trycollate.ai/v1/prior-authorizations/authorization_id/manual-handoffs/handoff_id \
>	-H "Authorization: Bearer <apiKey>"