Skip to main content
POST
/
v2
/
users
/
{userId}
/
kyc
/
passport
/
international
Verify Passport (International)
curl --request POST \
  --url https://api.stablepay.global/v2/users/{userId}/kyc/passport/international \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "<string>",
  "fileName": "<string>",
  "deviceId": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.stablepay.global/llms.txt

Use this file to discover all available pages before exploring further.

​
Verify International Passport

Upload the user’s passport as a photo or PDF. We extract all data via OCR and mark KYC as verified.
​
file
string
required
Base64-encoded passport photo or PDF
​
fileName
string
File name (e.g., “passport.jpg”)
​
deviceId
string
Device identifier

​
Request

curl -X POST https://api.stablepay.global/v2/users/{userId}/kyc/passport/international \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "<base64-encoded-passport>",
    "fileName": "passport.jpg"
  }'

​
Response

{
  "success": true,
  "data": {
    "verified": true,
    "givenName": "VZOR",
    "surname": "SPECIMEN",
    "nationality": "Slovakia",
    "countryCode": "SVK",
    "dob": "111111"
  }
}
Once verified, the user’s KYC status is automatically updated.

​
Supported Documents

Any machine-readable passport (MRP) with an MRZ zone. Supports passports from all countries.

​
Errors

CodeDescription
Already VerifiedPassport already verified for this user
Verification FailedCould not extract passport data from image
Bad RequestFile missing or invalid format