---
title: "List checkouts"
method: GET
path: "/gateway/sessions"
tags: ["Checkouts"]
---

# List checkouts

`GET /gateway/sessions`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/sessions`
- Auth: API key in header `x-api-key`

Paginated. Same fields as create, per item.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'open' | 'completed' | 'expired' | 'cancelled'
- `networks` string

## Response `200`

A page of checkouts.

- CheckoutListResponse
  - `items` Checkout[], required
    - `id` string, uuid, required: Internal checkout UUID.
    - `payment_link_id` string, uuid, nullable, required
    - `org_id` string, uuid, required
    - `session_id` string, required: Public ID, used in the checkout URL and as the path parameter for every other call on this resource.
    - `idempotency_key` string, nullable, required
    - `amount_override` number, nullable, required: Set only if you passed amount or amountOverride at create.
    - `currency` string, required
    - `metadata` object, required
    - `webhook_url` string, nullable, required
    - `success_url` string, nullable, required
    - `cancel_url` string, nullable, required
    - `tax_rate_id` string, uuid, nullable, required
    - `supported_networks` string[], required
    - `expires_at` string, date-time, required
    - `status` 'open' | 'completed' | 'expired' | 'cancelled', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `seller_mode` 'mor' | 'crypto', required
    - `environment` 'test' | 'live', required
    - `checkoutUrl` string, required: Send your buyer here. Computed, camelCase.
    - `invoiceId` string, uuid, nullable: Set once an invoice has been issued for this session; null until then.
    - `invoiceNumber` string, nullable
  - `total` integer, required
  - `hasMore` boolean, required

## Other responses

- `401`: Missing or invalid `x-api-key`.

---

[API](https://skmtc.dev/agentaos/apis/agentaos-gateway-api.md) · [All operations](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/revisions/3a8ad3c6b965?raw)