Verify credentials programmatically
Confirm any AIPA credential from your own systems — for background checks, HR onboarding, or partner directories — with a simple, keyed REST API and standards-based badges.
Verification API
A single read-only endpoint returns the live status of a credential by its ID. Use it to verify candidates at scale instead of checking each credential by hand.
GET https://aipalliance.org/api/v1/credentials/{credentialCode}Need a key? Contact us with your use case and we'll issue one.
Authentication
Pass your API key as a Bearer token (recommended) or a key query parameter.
curl https://aipalliance.org/api/v1/credentials/AIPA-CAIP-2026-7F3K9Q \
-H "Authorization: Bearer aipa_live_xxxxxxxxxxxxxxxxxxxx"Response & statuses
A successful lookup returns the holder, credential, and live status:
{
"found": true,
"code": "AIPA-CAIP-2026-7F3K9Q",
"status": "valid",
"valid": true,
"holder": "Jordan Lee",
"credential": "Certified AI Practitioner",
"credentialId": "caip",
"score": 86,
"issuedAt": "2026-03-14T10:21:00.000Z",
"expiresAt": "2029-03-14T10:21:00.000Z",
"verifyUrl": "https://aipalliance.org/verify/AIPA-CAIP-2026-7F3K9Q"
}status is one of valid, expired, or revoked. Expiry is computed live; revoked credentials (e.g. via a Trust & Safety sanction) report revoked immediately.
Errors & rate limits
| Code | Meaning |
|---|---|
| 200 | Found — credential payload returned. |
| 401 | Missing or invalid API key. |
| 404 | No credential with that ID. |
| 429 | Rate limit exceeded for your key. |
Each key has a per-minute rate limit (default 60 requests/min); contact us for higher limits.
Open Badges 3.0 / Verifiable Credentials
Every credential is also available as an Open Badges 3.0 (W3C Verifiable Credential) document — ingestible by badge wallets and credential platforms. Verification is hosted: the credential's id resolves to its public verification page.
GET https://aipalliance.org/api/credentials/{credentialCode}/badgeAdd to LinkedIn
Credential holders can add their certification to a LinkedIn profile in one click from their dashboard or any public verification page — pre-filled with the credential name, issuer, ID, and verification URL.
No-code verification
No integration needed? Anyone can confirm a credential at aipalliance.org/verify — the same live status, shown as a page.