# License Proof

> Verify professional licenses from authoritative public sources. Deterministic, evidence-backed results for AI agents: queried live from official licensing-authority publications, original status wording preserved, never fabricated.

Price: 0.018 USDC per charged verification, paid with x402 (exact scheme, USDC on Base mainnet, eip155:8453). SOURCE_UNAVAILABLE and UNABLE_TO_VERIFY are never charged. Quotes, coverage and validation are free.
City Advantage: 20% off with a valid America Agent City referral token in the X-City-Referral header (same token on the quote and the paid retry): https://americaagent.city/docs/city-advantage.md

## Use
1. POST https://licenseproof.online/api/v1/verify with JSON {"name": "...", "license_number": "optional", "profession": "nurse", "jurisdiction": "US-CO"} → 402 with the x402 requirement, price and the official source that will be queried.
2. Resend the identical body with headers PAYMENT-SIGNATURE (x402 payload) and Idempotency-Key (16–128 chars) → 200 with result, evidence and settlement.
3. Retrieve later (free): GET https://licenseproof.online/api/v1/verifications/{verification_id} with Authorization: Bearer <Idempotency-Key>.

## Results
- VERIFIED_ACTIVE: The official source lists the license as active. Charged.
- VERIFIED_INACTIVE: Listed, but not active (inactive, surrendered, retired, cancelled, deceased, delinquent registration…). Charged.
- EXPIRED: Listed as expired or lapsed. Charged.
- SUSPENDED: Listed as suspended. Charged.
- REVOKED: Listed as revoked, disbarred or an equivalent removal. Charged.
- RESTRICTED: Active with conditions, restrictions or probation. Charged.
- NOT_FOUND: No matching record in the source. Not proof of never having been licensed. Charged.
- AMBIGUOUS: Several licenses match; candidates are returned with their license numbers. Charged.
- SOURCE_UNAVAILABLE: The official source could not be reached. Not charged.
- UNABLE_TO_VERIFY: The source answered but the evidence does not support a status (unreadable response, application-only record, unknown status wording, or too many partial name matches). Not charged.

NOT_FOUND never means "never licensed". "Could not retrieve" is SOURCE_UNAVAILABLE, never NOT_FOUND.

## Coverage (official sources only)
- US-CO (Colorado): accountant, architect, dentist, electrician, engineer, nurse, pharmacist, physician, physician_assistant, plumber, veterinarian
- US-CT (Connecticut): accountant, architect, contractor, dentist, electrician, engineer, hvac, nurse, pharmacist, physician, physician_assistant, plumber, real_estate, veterinarian
- US-IL (Illinois): accountant, architect, contractor, dentist, engineer, nurse, pharmacist, physician, physician_assistant, real_estate, veterinarian
- US-NY (New York): attorney, real_estate
- US-TX (Texas): electrician, hvac
- US-WA (Washington): contractor, electrician, plumber
- CA-QC (Québec): contractor
Everything else is rejected before payment with HTTP 422 (not charged). Details: https://licenseproof.online/api/v1/coverage

## Documents
- OpenAPI: https://licenseproof.online/openapi.json
- Docs: https://licenseproof.online/docs
- Coverage: https://licenseproof.online/api/v1/coverage
- Pricing: https://licenseproof.online/api/v1/pricing
- Service descriptor: https://licenseproof.online/.well-known/license-proof.json
- Terms: https://licenseproof.online/terms · Privacy: https://licenseproof.online/privacy

Operated by Active Life Hub LLC. License Proof reports what licensing authorities publish; it does not issue licenses.