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

# Response format

> Standard success, error and paginated response envelopes.

Every response uses a consistent JSON envelope with a top-level `success` flag.

## Success

```json theme={null}
{
  "success": true,
  "data": {}
}
```

## Error

```json theme={null}
{
  "success": false,
  "code": "validation_error",
  "message": "The request contains invalid data.",
  "errors": {
    "email": ["Enter a valid email address."]
  }
}
```

| Field     | Type    | Description                            |
| --------- | ------- | -------------------------------------- |
| `success` | boolean | Always `false` on errors               |
| `code`    | string  | Machine-readable error code            |
| `message` | string  | Human-readable description             |
| `errors`  | object  | Optional field-level validation errors |

## Paginated list response

List endpoints wrap results in a `data` array and add a `pagination` object.

```json theme={null}
{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 320,
    "pages": 7
  }
}
```