# List checkout sessions
Source: https://docs.lomi.africa/api/checkout-sessions/CheckoutSessionsController_findAll

List checkout sessions

***

title: "List checkout sessions"
description: "List checkout sessions"
full: true
method: get
path: /checkout-sessions
operationId: CheckoutSessionsController\_findAll
------------------------------------------------

## Overview

List checkout sessions

Lists checkout sessions with filters for status, time range, and pagination per your integration needs.

### When to use this

Use for reconciliation, support tools, or exporting recent checkout attempts.

### See also

[Retrieve checkout session](/api/checkout-sessions/CheckoutSessionsController_findOne)

## 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`

Base URLs:

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

## Request

### Path parameters

*No path parameters beyond the URL pattern.*

### Query parameters

| Name     | In    | Required | Schema | Description                                                      |
| -------- | ----- | -------- | ------ | ---------------------------------------------------------------- |
| `offset` | query | No       | -      | Décalage pour la pagination                                      |
| `limit`  | query | No       | -      | Nombre maximal de résultats                                      |
| `status` | query | No       | -      | Filtrer par statut de session (valeur checkout\_session\_status) |

## Responses

| Status | Description                |
| ------ | -------------------------- |
| `200`  | Success                    |
| `401`  | Invalid or missing API key |

## 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?offset=1&limit=1" \
  -H "X-API-KEY: $LOMI_SECRET_KEY"
```

## OpenAPI

* **operationId**: `CheckoutSessionsController_findAll`
* **Operation**: `GET /checkout-sessions`

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