Skip to main content
The Customer API puts KYC data capture in your hands. You are responsible for capturing the required customer data and submitting it through the API, whether you build the capture flow yourself or delegate it to a KYC provider. Use this page as your pre-integration reference. Each section covers one of the requirement categories that appear in kyc.requirements on GET /platform/v1/customers/{id}: basicDetails, residentialAddress, and phoneNumber (the profile fields), plus taxIdentifiers, identityDocuments, selfie, and proofOfAddress. You fulfill field-based categories with PATCH /platform/v1/customers/{id}/kyc and document-based categories with the file-upload endpoints. Country is the key driver: once you submit residentialAddress.country, the API returns the full requirement set for that jurisdiction.

​
Profile fields

Every customer requires the following profile fields, submitted with PATCH /platform/v1/customers/{id}/kyc. The API path is the field’s location in the PATCH body. Date of birth must be in YYYY-MM-DD format. The customer must be 18 or older. Country codes must be ISO 3166-1 alpha-3 (e.g. USA, GBR, DEU).
Phone number must be in E.164 format (e.g. +12025550143). Verify the customer’s phone number via OTP before submitting it. Re-verify at least once every 30 days.

​
Tax identifiers

Tax identifier requirements depend on the customer’s country of residence. Submit tax identifiers as taxIdentifiers[] on PATCH /platform/v1/customers/{id}/kyc, each with a type, value, and (for tin) a country field.

​
EEA and UK

​
Rest of world

​
Identity documents

When identityDocuments is incomplete in kyc.requirements, the customer must provide one of the document types listed below. Submit documents through the presigned upload flow, not inline in the PATCH body.
Accepted document types vary by country.

​
Acceptance by country

The table below shows which documents MoonPay accepts per country.

​
Proof of address

When proofOfAddress is incomplete in kyc.requirements, the customer must submit a document confirming their residential address. Submit it through the presigned upload flow. Accepted documents
  • Utility bills (electricity, gas, internet, landline, or water)
  • Bank or credit card statements
  • Mortgage statement
  • Certificate of voter registration
  • Government correspondence (for example, from a tax authority or licensing body)
  • Lease agreements or rent receipts
  • Insurance documents
  • Tax documents
  • Official letters from schools, employers, or government agencies
  • Employer’s certificate (payslips are not accepted)
  • Certificate of vehicle registration
Recency Documents must be dated within the last 90 days. Documents outside this window are rejected. Country coverage The accepted document list applies globally with no country-specific restrictions.

​
Selfie and liveness check

Details on selfie and liveness check requirements are being finalized. Contact your MoonPay account team if you need this information sooner.