passport-photo-specs (Python)

Canonical passport, visa, and ID document photo specifications validated against 15+ official government sources. 100+ countries, 248 document formats. Python distribution of the passport-photo-specs dataset.

Useful for:

• Building passport / visa photo tools without re-researching per-country specs
• Validating photo uploads before submitting to a government portal (DS-160, COVA, Sarathi, voters.eci.gov.in, etc.)
• Immigration / visa software that needs correct dimensions and background colors
• ML training corpora for biometric photo compliance
• Research on ICAO 9303 / biometric photo standards across jurisdictions

Install

pip install passport-photo-specs

Quick start

from passport_photo_specs import find_document, find_country, countries, documents

# Look up a specific document
italy_visa = find_document("italy-visa-photo")
print(italy_visa["widthMm"], italy_visa["heightMm"], italy_visa["dpi"])
# 35 45 300

# Look up a country (by id or by any of its document slugs)
italy = find_country("italy")
print(italy["name"], len(italy["documents"]))
# Italy 3

# Iterate everything
print(f"Total countries: {len(countries())}")
print(f"Total document formats: {len(documents())}")

# Get the raw dict if you want to walk it yourself
from passport_photo_specs import raw
all_data = raw()

What's in each document spec

{
    "id": "italy-visa",
    "countryId": "italy",
    "name": "Italian Visa",
    "slug": "italy-visa-photo",
    "widthMm": 35,
    "heightMm": 45,
    "widthPx": 413,
    "heightPx": 531,
    "dpi": 300,
    "background": "Plain light grey",
    "bgColor": "#eeeeee",
    "bgColorLabel": "Light grey",
    "requirements": ["Size: 35×45 mm", ...],
    "seoTitle": "...",
    "h1": "...",
    "faq": [{"q": "...", "a": "..."}, ...],
}

Source-of-truth: validated against the issuing-authority's published guidance. The full source list is in the parent repository's README.

Citation

This dataset is archived on Zenodo with a citable DOI. Use the concept DOI to always resolve to the latest version:

whitetirocket. (2026). passport-photo-specs: Open Dataset of Passport, Visa, and ID Photo Specifications for 100+ Countries. Zenodo. https://doi.org/10.5281/zenodo.20409880

See also

• npm: passport-photo-specs — TypeScript / JavaScript
• GitHub (canonical): whitetirocket/passport-photo-specs
• Zenodo dataset record: zenodo.org/records/20409881
• Reference implementation: idphotosnap.com — browser-only passport photo tool that consumes this dataset

License

MIT. See LICENSE.