---
title: "Get checkout, fulfilment, and shipment status"
method: GET
path: "/api/checkout-status"
tags: ["Checkout"]
---

# Get checkout, fulfilment, and shipment status

`GET /api/checkout-status`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/checkout-status`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.createprints.ai/api/oauth/authorize`, token URL `https://api.createprints.ai/api/oauth/token`, scopes: `checkout:read`)

For a simple payment lookup, provide `sessionId` and omit `view`. For the combined agent workflow, set `view=agent` and provide at least one of `jobId`, `sessionId`, or `orderId`. Agent view combines artwork readiness, checkout state, print-asset preparation, production, shipments, and a machine-readable `nextAction`. A signed-in user-session token is accepted for this read operation in addition to account API keys and MCP OAuth tokens.

## Query parameters

- `sessionId` string
- `jobId` string, uuid
- `orderId` string, uuid
- `view` 'agent'

## Response `200`

Current payment and, when requested, fulfilment and shipment state.

- union
  - SimpleCheckoutStatus
    - `checkoutSessionId` string, required
    - `status` string, nullable, required
    - `paymentStatus` string, nullable, required
    - `orderId` string, uuid, nullable, required
  - AgentCheckoutStatus
    - `code` 'ok', required
    - `job` AgentJobState, required
      - `id` string, uuid, required
      - `status` string, required
      - `purchasable` boolean, required
      - `nextAction` string, required
    - `checkout` AgentCheckoutState, required
      - `sessionId` string, nullable, required
      - `status` string, nullable, required
      - `paymentStatus` string, nullable, required
      - `orderId` string, uuid, nullable, required
      - `nextAction` string, required
    - `fulfillment` FulfilmentStatus, required
      - `orderId` string, uuid, required
      - `stage` string, required
      - `retryable` boolean, required
      - `nextAction` string, required
      - `items` FulfilmentItem[]
        - `id` string, uuid, required
        - `generationJobId` string, uuid, required
        - `productVariantId` string, uuid, required
        - `quantity` integer, required
        - `status` 'pending' | 'ready' | 'failed', required
      - `retryFulfillment` object
    - `orderStatus` ProductionStatus, required
      - `stage` string, required
      - `isShipped` boolean, required
      - `shipments` Shipment[], required
        - `status` string, required
        - `shippedAt` string, date-time, nullable, required
        - `carrier` string, nullable, required
        - `trackingNumber` string, nullable, required
        - `trackingUrl` string, uri, nullable, required
      - `updatedAt` string, date-time, nullable, required
      - `nextAction` string, required

## Other responses

- `400`: Missing or invalid input.
- `401`: The credential is missing, invalid, revoked, or expired.
- `403`: The credential lacks the required scope or cannot perform this operation.
- `404`: The resource was not found for the authenticated account.
- `500`: Create Prints could not complete the request.

---

[API](https://skmtc.dev/createprints/apis/create-prints-api.md) · [All operations](https://skmtc.dev/createprints/apis/create-prints-api/llms.txt) · [OpenAPI document](https://skmtc.dev/createprints/apis/create-prints-api/revisions/05c57f496d51?raw)