Free Tier for AI Agents

1. Create a temporary email

curl -X POST https://api.aidenid.com/v1/free/identity

# Response:
{
  "identityId": "id_abc123...",
  "emailAddress": "agent-8f3c1a2b@free.aidenid.dev",
  "expiresAt": "2026-04-05T22:00:00Z",
  "apiToken": "free_aBc123...",
  "pollUrl": "/v1/free/identity/id_abc123/extraction"
}

2. Use the email address

Use the returned emailAddress to sign up for a service, verify an account, or test an auth flow. When the service sends an OTP or verification link, AIdenID captures it automatically.

3. Poll for the OTP

# Poll every 30 seconds until the OTP arrives
curl "https://api.aidenid.com/v1/free/identity/id_abc123/extraction?token=free_aBc123"

# 202 — Not ready yet:
{ "status": "pending", "retryAfterSeconds": 30 }

# 200 — OTP received:
{
  "status": "ready",
  "otp": "482931",
  "type": "RULES",
  "confidence": 0.98,
  "receivedAt": "2026-04-04T22:05:00Z"
}

Limits