> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talescria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a checkout session

> Check whether a checkout session has been paid.

Returns a session as it stands. No credential is needed: the session ID is the key. Poll this from your server and fulfil the order once `state` is `completed`.

**id** `string` *required*

The session ID.

### Response

**session** `object`

**properties**

**id** `string`

The session ID.

**state** `string`

`open`, `processing`, `completed`, `cancelled` or `expired`. Only `completed` means paid.

**amount** `object`

`minorUnits` and `currency`.

**country** `string`

ISO 3166-1 alpha-2.

**merchantName** `string | null`

Your business's verified name, as shown to the payer.

**environment** `string`

`test` or `live`.

**availableMethods** `string[]`

Methods the payer can use.

**paymentId** `string | null`

The payment, once one has been made.

**underReview** `boolean`

While `processing`: held for a compliance review. Nothing charged yet.

**attempts** `object[]`

Each attempt's `method`, `outcome` (`pending`, `processing`, `succeeded`, `declined` or `errored`) and `declineCode`.

**createdAt** `integer`

Epoch milliseconds.

**expiresAt** `integer`

Epoch milliseconds. A `processing` session doesn't expire.

**updatedAt** `integer`

Epoch milliseconds.

### Errors

| Status | Code | Meaning |
| - | - | - |
| `404` | `NOT_FOUND` | No such session. |

```bash curl theme={null}
curl https://pay.talescria.com/v1/sessions/chk_3f6e2c1a-…
```

```python Python theme={null}
resp = requests.get(f"https://pay.talescria.com/v1/sessions/{session_id}", timeout=30)
session = resp.json()["session"]
paid = session["state"] == "completed"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.