GET /api/v1/checkout-sessions/:id — Fetch Checkout Session

Poll this endpoint to check whether a subscriber has completed payment for a given checkout session. The response includes the full session state, associated service and payment plan details, the pre-associated user if one was set, and any subscriptions that were created upon payment completion.

GET https://api.retempo.xyz/api/v1/checkout-sessions/:checkoutSessionId

Path Parameters

checkoutSessionId

string

required

The unique identifier of the checkout session to retrieve.

Response

A successful request returns HTTP 200 OK with the full checkout session object.

checkoutSession

object

The requested checkout session.

Show checkoutSession fields

string

Unique identifier for the checkout session.

serviceId

string

ID of the associated service.

paymentPlanId

string

ID of the associated payment plan.

userId

string | null

ID of the pre-associated user, or null if not set.

status

string

Current session status — PENDING, PAID, EXPIRED, or CANCELLED.

expiresAt

string | null

Expiry datetime, or null if not set.

createdAt

string

ISO 8601 datetime the session was created.

service

object

Nested service object with id, name, and status.

paymentPlan

object

Nested payment plan with id, name, amount, and currency.

user

object | null

Nested user object if a userId was associated, otherwise null.

subscriptions

array

List of subscriptions created when payment was completed. Empty while the session is still PENDING.

200 — Checkout session retrieved

{
  "checkoutSession": {
    "id": "clz1checkout789",
    "serviceId": "clz1abc2def3ghi4",
    "paymentPlanId": "clz1plan567",
    "userId": null,
    "status": "PENDING",
    "expiresAt": "2025-06-02T10:00:00.000Z",
    "createdAt": "2025-06-01T10:10:00.000Z",
    "service": {
      "id": "clz1abc2def3ghi4",
      "name": "DataStream Pro",
      "status": "ACTIVE"
    },
    "paymentPlan": {
      "id": "clz1plan567",
      "name": "Pro Monthly",
      "amount": "49.000000",
      "currency": "USDC"
    },
    "user": null,
    "subscriptions": []
  }
}

Example Request

curl https://api.retempo.xyz/api/v1/checkout-sessions/clz1checkout789

Error Codes

Status	Message	Condition
`404 Not Found`	`Checkout session was not found.`	No session exists for the provided ID.

Check the subscriptions array in the response — a non-empty list means payment was completed and a subscription is active.

​Path Parameters

​Response

​200 — Checkout session retrieved

​Example Request

​Error Codes

Path Parameters

Response

200 — Checkout session retrieved

Example Request

Error Codes