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

# Response Format

> The standard response envelope returned by every endpoint

## Success envelope

Every successful call returns HTTP `200` with this structure:

```json theme={null}
{
  "status": 200,
  "message": "Balance fetched successfully",
  "data": "<encrypted base64 payload>"
}
```

| Field     | Type   | Description                                                                                      |
| --------- | ------ | ------------------------------------------------------------------------------------------------ |
| `status`  | number | HTTP status code                                                                                 |
| `message` | string | Human-readable summary of the result                                                             |
| `data`    | string | The response payload, encrypted to your Ed25519 public key; see [Encryption](/guides/encryption) |

<Note>
  Throughout the API Reference, response examples show the **decrypted** contents of `data` so you can see the actual payload shape. On the wire, `data` is always an encrypted base64 string.
</Note>

## Error envelope

Errors return the status and message with no `data` field:

```json theme={null}
{
  "status": 400,
  "message": "Invalid api key"
}
```

Permission failures use a slightly different shape:

```json theme={null}
{
  "status": false,
  "message": "Permission denied"
}
```

See the [Error Reference](/guides/errors) for the full list.

## Pagination

List endpoints such as [Get Transactions](/api-reference/get-transactions) return paginated data:

```json theme={null}
{
  "data": [ ... ],
  "pagination": {
    "count": 42,
    "pages": 5,
    "isLastPage": false,
    "nextPage": 2,
    "previousPage": null
  }
}
```

| Field          | Type           | Description                                       |
| -------------- | -------------- | ------------------------------------------------- |
| `count`        | number         | Total number of records                           |
| `pages`        | number         | Total number of pages                             |
| `isLastPage`   | boolean        | Whether the current page is the last              |
| `nextPage`     | number \| null | Next page number, or `null` on the last page      |
| `previousPage` | number \| null | Previous page number, or `null` on the first page |