# Proof of Human — API reference

> Verify one-file C2PA audio or a legacy audio + `.poh` pair and manage API keys — a report-only, model-first API documented from the live OpenAPI contract.

The API checks a PoH-signed account of the editing PoH witnessed and its binding to the exact export. It accepts a credentialed audio file by itself or the legacy audio + `.poh` pair. Results and grades are report-only; your screening policy stays yours. Auth is an API key in the `x-api-key` header.

## The reference

The page renders a full three-pane API reference — endpoint sidebar, operation docs, request/response models with SDK and curl code samples — read live from the deployed OpenAPI spec. Everything is generated from the PoH TypeSpec model, so the docs can't drift from the API. API keys stay server-side (keyed routes serve no CORS), so integrate via the SDK or curl rather than in-browser calls.

- [OpenAPI JSON](https://proofofhuman.fm/openapi.json) — the partner-only machine-readable contract
- [API changelog](/developers/changelog) — dated API changes and the change policy

## Use with AI

For your coding agent:

- **Copy full API context** — [llms-full.txt](https://proofofhuman.fm/llms-full.txt): every endpoint + parameters, paste into any agent
- **Copy concise endpoint map** — [llms.txt](https://proofofhuman.fm/llms.txt): a compact routing map
- Or open in Claude / ChatGPT with the prompt: “Read https://proofofhuman.fm/llms-full.txt — the full Proof of Human API reference — and help me integrate proof verification into my app.”

## TypeScript SDK

```
npm install @proof-of-human/ts-sdk
```

The reference's version chip mirrors the spec's version — which is the published SDK version, so the badge, the docs, and npm can never disagree.

---

More: [llms.txt](https://proofofhuman.fm/llms.txt) · [sitemap](https://proofofhuman.fm/sitemap.md)