> 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.

# Contact object

## Attributes

| Attribute     | Type              | Description                                                                                                                           |
| :------------ | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------ |
| `name`        | string `required` | Full name of contact. Limited to 255 characters.                                                                                      |
| `line1`       | string `required` | First line of the address. Limited to 128 characters.                                                                                 |
| `line2`       | string            | Second line of the address. Limited to 128 characters.                                                                                |
| `suburb`      | string            | City or suburb name. Limited to 128 characters.                                                                                       |
| `state`       | string            | State (or Town/City for NZ). Limited to 128 characters.                                                                               |
| `postcode`    | string `required` | [ZIP](https://en.wikipedia.org/wiki/ZIP_Code) or [postal code](https://en.wikipedia.org/wiki/Postal_code). Limited to 128 characters. |
| `countryCode` | string            | The two-character [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country code.                                                |
| `phoneNumber` | string            | The phone number, in [E.123](https://en.wikipedia.org/wiki/E.123) format. Limited to 32 characters.                                   |

## Example Contact object

**`UK`**

```json UK
{
  "name": "Joe Consumer",
  "line1": "1 Market Street",
  "suburb": "MANCHESTER",
  "postcode": "M4 3AT",
  "countryCode": "GB",
  "phoneNumber": "07000000000"
}
```