Passport Photo API

Free: face detection, cropping, resizing and the finished photo with a watermark across it. Everything the API returns is free.

$9.99 one-time: the same photo without the watermark, print-ready. The response includes a checkout.url you can hand to the user; they pay there and download it. There is no subscription and no per-seat fee.

You are never charged for calling the API. The payment is between the end user and us, at the point they want the clean file.

Creates a compliant photo. The source should be front-facing with the whole head visible and even lighting.

{
  "image": "<base64, or a data:image/jpeg;base64,... URL>",
  "document": "us-passport",
  "email": "optional@example.com"
}

Response

{
  "id": "api_mh8x2k_9fjs02la",
  "document": {
    "id": "us-passport",
    "name": "US Passport",
    "output": { "width": 600, "height": 600, "dpi": 300,
                "inches": "2×2", "mm": "51×51" }
  },
  "photo": {
    "watermarked": true,
    "width": 600, "height": 600, "dpi": 300,
    "data": "data:image/jpeg;base64,..."
  },
  "checkout": {
    "url": "https://2x2passportphoto.com/result/api_mh8x2k_9fjs02la",
    "price": { "amount": 9.99, "currency": "USD" },
    "description": "One-time payment for the watermark-free file."
  }
}

Max image size 10MB. Images larger than ~1500px on the long edge are downscaled before detection, so sending a 12MP phone photo only costs you upload time.

Whether that photo has been purchased yet. Returns paid, a previewUrl (watermarked, always available) and a downloadUrl once it is paid for.

All 41 supported document types with the exact pixel dimensions each one returns.

One document in full: output size, the framing ratios we target, and the issuing authority's rules on background, glasses, expression and clothing — plus the reasons photos of that type get rejected.