Reference Downloads

APIS Contracts

• APIS v2.1 DOI record
• APIS concept DOI (latest line)
• APIS v2.1 Delta PDF
• APIS v2.0 Canonical PDF
• APIS v2.0 Implementation Guide
• APIS System Primer PDF
• Passport Alliance Charter
• APIS v2.0 OpenAPI YAML
• APIS v2.0 JSON Schema
• Registry API OpenAPI JSON
• Alliance Root Key (well-known)
• Herman Reference Proof PDF

DOI and Record

• DOI: 10.5281/zenodo.21042004
• Concept DOI: 10.5281/zenodo.18820876
• Published: June 29, 2026
• Status: Version 2.1 — Canonical — Supersedes APIS v2.0
• Note: local PDF artifacts in this repo still include the v2.0 files plus the system primer; update the downloadable v2.1 PDF here when the publication artifact is added to the repo.

Conformance Definitions

• Proof of Possession Test YAML
• Revocation Test YAML
• JWKS Publication Test YAML

Fetch via CLI

curl -O https://docs.passportalliance.org/spec/apis-v2.openapi.yaml
curl -O https://docs.passportalliance.org/spec/apis-v2.schema.json
curl -O https://docs.passportalliance.org/spec/registry.openapi.json
curl -L https://doi.org/10.5281/zenodo.21042004
curl -O https://docs.passportalliance.org/spec/APIS-v2.0.pdf
curl -O https://docs.passportalliance.org/.well-known/alliance-root.jwk
curl -O https://docs.passportalliance.org/registry/HERMAN-PROOF.pdf

Versioning Guidance

Pin these artifacts by commit or release tag in CI pipelines. Do not consume unpinned contracts for production compliance gates.