Agentic checkout (UCP)

UCP: get a checkout

Return the latest state of a checkout session inside the ucp negotiation envelope. Status uses the UCP vocabulary (incomplete, ready_for_complete, complete_in_progress, completed, canceled) and amounts are integer cents in USD. An unknown id, or one owned by another credential, is a business outcome: HTTP 200 with ucp.status: error and a not_found message. Requires a bearer token; the sandbox key returns sandbox sessions.

get/api/ucp/checkout-sessions/{id}

Request

  • Base URL: https://www.adadiamonds.com
  • URL: https://www.adadiamonds.com/api/ucp/checkout-sessions/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://www.adadiamonds.com/oauth/authorize, token URL https://www.adadiamonds.com/api/oauth/token; client credentials, token URL https://www.adadiamonds.com/api/oauth/token, scopes: cart:write)

Path parameters

idstring required

Checkout session id returned by create.

Headers

UCP-Agentstring required

Platform profile, RFC 8941 dictionary syntax: profile="https://platform.example/.well-known/ucp".

Request-Idstring

Trace id; echoed back when provided.

Response

Checkout resource inside the ucp envelope. Business outcomes, including not-found and cannot-cancel, are HTTP 200 with messages[].

idstring required
status'incomplete' | 'requires_escalation' | 'ready_for_complete' | 'complete_in_progress' | 'completed' | 'canceled' required
currency'USD' required
expires_atstring date-time
continue_urlstring uri
fulfillmentobject
paymentobject

Example response

{
  "ucp": {
    "version": "2026-04-08"
  },
  "id": "ucp_1f6a5b2e-4c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "order": {
    "label": "#AD-2026-123456"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.