getCheckoutSession

Get a checkout session

Returns a checkout session with its status and, once completed, the order it made and that order's first invoice. Answers 404 when no session has that ID.

Path Parameters

id
Type: string
required

The checkout session's Spondo Billing ID.

Responses

application/json
application/json

get/checkout-sessions/{id}

curl https://billing.getspondo.com/api/v1/checkout-sessions/cs_3Hq7Zt1Xv5Nc9Bm2 \
  --header "Authorization: Bearer $SPONDO_API_KEY"

Show Schema

{
  "id": "cs_3Hq7Zt1Xv5Nc9Bm2",
  "checkoutId": "chk_9Xq2Lm7Rt4Vw1Bn8",
  "status": "completed",
  "customerId": "cus_Z8rT3nW6yP0aJc5E",
  "externalCustomerId": "northwind",
  "clientReferenceId": null,
  "selectedProduct": {
    "id": "prod_7Hk2LmQ9xR4tVb1N",
    "plan": {
      "id": "plan_4Fd8sK1mW9qZ2xCv",
      "name": "Growth",
      "externalId": "growth-monthly"
    }
  },
  "orderId": "ord_5Rk1Tz8Wn3Yb6Hd0",
  "invoiceId": "inv_2Gm6Px9Qs4Vc7Kj1",
  "createdAt": "2026-11-09T14:00:00.000Z",
  "completedAt": "2026-11-09T14:06:31.000Z",
  "expiresAt": "2026-11-10T13:30:00.000Z"
}

The checkout session.

List checkout sessions

Signals