Developer documentation

Machine-readable verification for public cryptographic identity.

Profile lookup

Resolve a username to public keys and verified identity claims.

bash
curl https://pubid.io/api/profile/ian

Key by fingerprint

Always look up keys by full fingerprint. Short IDs are not safe.

bash
curl https://pubid.io/api/keys/<fingerprint>

Status check

Lightweight endpoint suitable for CI. Returns active / expired / revoked / superseded.

bash
curl https://pubid.io/api/keys/<fingerprint>/status

Proofs

List of all identity proofs linked to a key, with timestamps.

bash
curl https://pubid.io/api/keys/<fingerprint>/proofs

Trust model

  • Ownership: signed challenge proves the user controls the private key.
  • Identity: external proofs bind the key to an email, domain, website, or account.
  • Proofs are time-bound. Stale proofs are surfaced explicitly.
  • Comments, UIDs, and SSH key comments are not proof.