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

# Customer export

> MoonPay-verified customer data returned by the export endpoint

Returned by [Export customer data](/api-reference/platform/endpoints/customers/export). All fields are populated from the customer's latest approved verification. Fields MoonPay does not hold are `null`.

## Properties

| Property             | Type   | Required | Description                                                                   |
| -------------------- | ------ | -------- | ----------------------------------------------------------------------------- |
| `basicDetails`       | object | Yes      | The customer's basic personal details                                         |
| `residentialAddress` | object | Yes      | The customer's residential address                                            |
| `phoneNumber`        | object | Yes      | The customer's phone number                                                   |
| `taxIdentifiers`     | array  | Yes      | Tax identifiers recorded for the customer. Empty when none are recorded       |
| `files`              | array  | Yes      | Identity documents the customer submitted, each with a presigned download URL |

## Basic details

| Property      | Type   | Required | Description                                                                                                          |
| ------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------- |
| `firstName`   | string | Yes      | The customer's first name. `null` for mononymous customers recorded with only a last name                            |
| `lastName`    | string | Yes      | The customer's last name. `null` for mononymous customers recorded with only a first name                            |
| `dateOfBirth` | string | Yes      | The customer's date of birth in `YYYY-MM-DD` format                                                                  |
| `nationality` | string | Yes      | The customer's nationality as an [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) country code |

## Residential address

| Property             | Type   | Required | Description                                                                                                                               |
| -------------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `country`            | string | Yes      | Country as an [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) country code                                         |
| `administrativeArea` | string | No       | State, province, or territory. Present when the country has subdivisions recognized by MoonPay (currently USA and CAN); omitted otherwise |
| `locality`           | string | Yes      | City, town, or locality                                                                                                                   |
| `street`             | string | Yes      | First line of the address (street)                                                                                                        |
| `subStreet`          | string | No       | Second line of the address (apartment, unit, building). Omitted when MoonPay does not hold this value                                     |
| `postalCode`         | string | Yes      | Postal or ZIP code                                                                                                                        |

## Phone number

| Property | Type   | Required | Description                                                                        |
| -------- | ------ | -------- | ---------------------------------------------------------------------------------- |
| `number` | string | Yes      | The customer's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format |

## Tax identifiers

| Property  | Type   | Required | Description                                                                                           |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| `type`    | string | Yes      | Type of tax identifier: `tin`, `ssn`, or `cpf`                                                        |
| `country` | string | No       | Issuing country as an ISO 3166-1 alpha-3 code. Present for `tin` entries; omitted for `ssn` and `cpf` |
| `value`   | string | Yes      | Identifier value as recorded by MoonPay                                                               |

## Files

| Property      | Type               | Required | Description                                                                                                            |
| ------------- | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| `id`          | string (uuid)      | Yes      | MoonPay's identifier for the file                                                                                      |
| `type`        | string             | Yes      | Type of file. See [File types](#file-types)                                                                            |
| `side`        | string             | No       | `front` or `back`. Present for two-sided document types; omitted for single-sided                                      |
| `uploadedAt`  | string (date-time) | Yes      | When MoonPay received the file                                                                                         |
| `downloadUrl` | string (uri)       | Yes      | Presigned download URL. Expires 60 minutes after the response is returned; do not attach your API key when fetching it |

### File types

| Value                    | Sides        |
| ------------------------ | ------------ |
| `passport`               | Single-sided |
| `driving_licence`        | Two-sided    |
| `national_identity_card` | Two-sided    |
| `residence_permit`       | Two-sided    |
| `selfie`                 | Single-sided |
| `proof_of_address`       | Single-sided |

## Example

```json theme={null}
{
  "basicDetails": {
    "firstName": "Jane",
    "lastName": "Doe",
    "dateOfBirth": "1990-01-15",
    "nationality": "USA"
  },
  "residentialAddress": {
    "country": "USA",
    "administrativeArea": "NY",
    "locality": "New York",
    "street": "350 Fifth Avenue",
    "subStreet": "Apt 1A",
    "postalCode": "10118"
  },
  "phoneNumber": {
    "number": "+14155551234"
  },
  "taxIdentifiers": [{ "type": "ssn", "value": "078-05-1120" }],
  "files": [
    {
      "id": "f1a2b3c4-0000-4000-8000-000000000000",
      "type": "passport",
      "uploadedAt": "2026-06-30T14:30:50.000Z",
      "downloadUrl": "https://files.moonpay.com/exports/f1a2b3c4...?signature=..."
    }
  ]
}
```