What the AI Verified API Does
The AI Verified API provides programmatic access to the registry of verified business passports. It is designed for three primary use cases: verifying a business before a transaction, enriching a CRM or directory with structured identity data, and building AI agent workflows that need to confirm a business's identity before acting on its behalf.
The API returns structured JSON-LD data for each verified business, including the passport hash, verification status, registered domain, schema.org Organization markup, and a list of authoritative external identifiers (Companies House number, VAT number, Wikidata Q-identifier, and similar).
Authentication
All API requests require a Bearer token in the Authorization header. You can generate an API key from your AI Verified dashboard under Settings → API Access. Free-tier keys are rate-limited to 100 requests per month. Startup, Professional, and Enterprise plans have higher quotas.
curl -H "Authorization: Bearer aiv_your_key_here" \
https://aiverified.io/api/v1/passport/lookup?domain=example.comCore Endpoints
The three most commonly used endpoints are passport lookup by domain, passport lookup by hash, and bulk verification. The domain lookup endpoint accepts a URL or bare domain and returns the most recently verified passport for that domain. The hash endpoint accepts a 64-character SHA-256 passport hash and returns the full passport record. Bulk verification accepts up to 50 domains in a single POST request.
Response Structure
Every successful response includes a passport object with the following fields: hash (the canonical passport identifier), status (verified, pending, or revoked), tier (bronze, silver, gold, or platinum), domain, businessName, registeredCountry, verifiedAt (ISO 8601 timestamp), and schema (the full JSON-LD Organization object).
Error Handling
The API uses standard HTTP status codes. A 404 means no passport exists for the queried domain or hash. A 429 means you have exceeded your rate limit. A 403 means your API key is invalid or has been revoked. All error responses include a machine-readable code field and a human-readable message.
Webhooks
Enterprise-tier API keys can subscribe to webhook events for passport status changes. This is useful for applications that need to be notified when a business's verification status changes — for example, when a passport is revoked or when a domain verification expires.