Developers
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 in the Authorization header. The samples read it from an AIPA_API_KEY environment variable, so it never sits in your code.
curl https://aipalliance.org/api/v1/credentials/AIPA-CAIP-2027-7F3A9C \ -H "Authorization: Bearer $AIPA_API_KEY"
Deprecated: sending the key as a ?key= query parameter still works for now, but responses carry a Deprecation header and support will be removed. Query strings are written to proxy and server logs, so if you have used one, move to the header and ask us to rotate the key.
Response & statuses
A successful lookup returns the holder, credential, and live status:
{
"found": true,
"code": "AIPA-CAIP-2027-7F3A9C",
"status": "valid",
"valid": true,
"holder": "Jordan Lee",
"credential": "Certified AI Practitioner",
"credentialId": "caip",
"issuedAt": "2027-03-14T10:21:00.000Z",
"expiresAt": "2028-03-14T10:21:00.000Z",
"verifyUrl": "https://aipalliance.org/verify/AIPA-CAIP-2027-7F3A9C"
}status is one of valid, expired, suspended, revoked or superseded (issued under a discontinued edition of the scheme). Only valid sets valid: true. Expiry is computed live; revoked credentials (for example after a misconduct 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.
Add 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.
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.
No-code verification
No integration needed? Anyone can confirm a credential at aipalliance.org/verify — the same live status, shown as a page.