> This page is for version v1.
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.clearpay.co.uk/v-2/llms.txt
> - v1: https://developers.clearpay.co.uk/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.clearpay.co.uk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.clearpay.co.uk/_mcp/server.

# Consumer object

## Attributes

| Attribute     | Type              | Description                                                                |
| :------------ | :---------------- | :------------------------------------------------------------------------- |
| `phoneNumber` | string            | The consumer’s phone number. Limited to 32 characters.                     |
| `givenNames`  | string `required` | The consumer’s first name and any middle names. Limited to 128 characters. |
| `surname`     | string `required` | The consumer’s last name. Limited to 128 characters.                       |
| `email`       | string `required` | The consumer’s email address. Limited to 128 characters.                   |

## Example Consumer object

**`UK`**

```json UK
{
  "phoneNumber": "07000000000",
  "givenNames": "Joe",
  "surname": "Consumer",
  "email": "test@example.com"
}
```