# Retrieve checkout session
Source: https://docs.lomi.africa/api/checkout-sessions/CheckoutSessionsController_findOne

Retrieve checkout session

***

title: "Retrieve checkout session"
description: "Retrieve checkout session"
full: true
method: get
path: /checkout-sessions/{id}
operationId: CheckoutSessionsController\_findOne
------------------------------------------------

## Overview

Retrieve checkout session

Returns session details including status and associated customer and line items where applicable.

### When to use this

Poll or display after redirect from checkout, or when handling async notifications keyed by session ID.

### See also

[List transactions](/api/transactions/TransactionsController_findAll)

## Authentication

Merchant routes require an API key in the `X-API-KEY` header (see [Integration overview](/api)). Use a **test** key against `https://sandbox.api.lomi.africa` and a **live** key against `https://api.lomi.africa`.

## Endpoint

`GET /checkout-sessions/{id}`

Base URLs:

* `https://sandbox.api.lomi.africa`
* `https://api.lomi.africa`

## Request

### Path parameters

| Name | Required | Schema | Description        |
| ---- | -------- | ------ | ------------------ |
| `id` | Yes      | -      | UUID de la session |

### Query parameters

*No query parameters.*

## Responses

| Status | Description                |
| ------ | -------------------------- |
| `200`  | Success                    |
| `401`  | Invalid or missing API key |
| `404`  | Resource not found         |

## Errors

Errors follow the standard JSON error format (status code and machine-readable message). Validate inputs before calling; **401** indicates a missing/invalid key, **404** a missing resource for this organization, **429** rate limiting. For safe retries on create-style calls, send an idempotency key when your flow supports it.

## Example

```bash
curl -sS -X GET "https://sandbox.api.lomi.africa/checkout-sessions/value" \
  -H "X-API-KEY: $LOMI_SECRET_KEY"
```

## OpenAPI

* **operationId**: `CheckoutSessionsController_findOne`
* **Operation**: `GET /checkout-sessions/{id}`

Full schemas and **Try it**: [API reference](/api). Machine-readable contract: repo `apps/docs/openapi.json`.
