Skip to main content
POST
Issue a presigned URL to upload a customer's identity-related file
Some Platform API capabilities must be enabled on your account by MoonPay before you can call them. If this endpoint returns an unexpected 404, see Capability enablement.

Authorizations

Authorization
string
header
required

Bearer authentication header using an access token.

Example: Authorization: Bearer <accessToken>

Path Parameters

id
string<uuid>
required

The customer's unique MoonPay identifier.

Body

application/json

Request body for issuing a presigned upload URL for an identity-related file.

fileType
enum<string>
required

Type of file the customer is uploading.

Available options:
drivingLicence,
nationalIdentityCard,
passport,
residencePermit,
selfie,
proofOfAddress,
proofOfIncome
mimeType
enum<string>
required

MIME type of the file being uploaded. Must match the Content-Type header used on the subsequent upload request.

Available options:
image/jpeg,
image/png,
application/pdf
side
enum<string>

Side of the document being uploaded. Required for two-sided file types (drivingLicence, nationalIdentityCard, residencePermit); must be omitted for single-sided file types.

Available options:
front,
back
sourceOfWealth
enum<string>

Source of wealth the file evidences. Required for proofOfIncome; must be omitted for all other file types.

Available options:
salary,
savings,
investments,
cryptoTrading,
companyProfits,
companySale,
propertySale,
soleProprietorIncome,
rentalIncome,
inheritance,
pension
subtype
enum<string>

Document subtype. Required for proofOfIncome and must be permitted for the declared sourceOfWealth; must be omitted for all other file types.

Available options:
payslip,
bankStatement,
accountScreenshot,
companyRegisterScreenshot,
dividendDistributionCertificate,
investmentPortfolioStatement,
invoice,
pensionStatement,
rentalAgreement,
saleContract,
signedLetterFromSolicitorOrTrustee

Response

The request has succeeded.

data
object
required

Presigned URL the partner uses to upload an identity-related file directly to MoonPay storage.