---
title: "Retrieve a checkout session"
method: GET
path: "/api/checkout/sessions/{sessionId}"
tags: ["Checkout Sessions"]
---

# Retrieve a checkout session

`GET /api/checkout/sessions/{sessionId}`

Returns the checkout session, including its status, associated `paymentId` (present once the buyer has submitted a payment method) and custom metadata.

Prefer subscribing to `checkout_session.*` merchant webhooks to be notified when the session completes and the `paymentId` is available. This endpoint is also available for on-demand retrieval.

## Path parameters

- `sessionId` string, required

## Response `200`

- ApiCheckoutSessionDto
  - `object` object, required — Object type discriminator
  - `id` string, required — Checkout session unique identifier
  - `status` 'open' | 'expired' | 'completed' | 'failed', required — Checkout session status
  - `type` 'one_time' | 'subscription', required — Checkout session type
  - `amount` number, required — Amount in cents
  - `currency` string, required — Currency code
  - `paymentId` string, nullable — Identifier of the payment associated with this session (present once the buyer has submitted a payment method)
  - `metadatas` object, nullable — Custom metadata attached to the session
  - `checkoutUrl` string, nullable — Hosted checkout URL for this session
  - `expiresAt` string, date-time, nullable — Expiration date of the session
  - `createdAt` string, date-time, required — Creation date
  - `updatedAt` string, date-time, required — Last update date

---

[API](https://skmtc.dev/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.dev/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/revisions/3012dd3dd14a/schema)