Customer export

MoonPay-verified customer data returned by the export endpoint

Returned by Export customer data. 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 country code

Residential address

Property	Type	Required	Description
country	string	Yes	Country as an 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 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
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

{
  "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": "[phone]"
  },
  "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=..."
    }
  ]
}