10-minute quickstart

This guide gets you from zero to a working v1 verification flow. You will: get a tenant API key, start a verification, and check its status. No SDK required — only curl (or any HTTP client).

Prerequisites

• A Loom API account (sign up at dashboard.loomapi.com)
• curl and jq (optional, for parsing JSON) installed

Step 1: Get your tenant API key

1. Sign in at dashboard.loomapi.com
2. Go to API Keys (or Keys)
3. Click Create New Key, name it (e.g. "Quickstart"), then copy the key immediately

The key is shown only once. If you lose it, create a new key. See Key Management.

Set it in your environment:

export LOOM_TENANT_API_KEY="your_key_here"

Step 2: Start a verification

Call the v1 start endpoint with your tenant key in the x-tenant-api-key header:

curl -s -X POST https://api.loomapi.com/verify/start \
  -H "x-tenant-api-key: $LOOM_TENANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

You should get a JSON response with verificationId and a URL (sessionUrl or redirectUrl). Example:

{
  "verificationId": "verif_abc123",
  "sessionUrl": "https://verify.loomapi.com/session/xyz",
  "redirectUrl": "https://verify.loomapi.com/session/xyz"
}

Save the verificationId; you need it for the next step.

Step 3: Check verification status

Poll the status endpoint with the verificationId from the start response:

curl -s "https://api.loomapi.com/verify/status?verificationId=verif_abc123" \
  -H "x-tenant-api-key: $LOOM_TENANT_API_KEY"

Replace verif_abc123 with your actual verificationId. Response example when completed:

{
  "verificationId": "verif_abc123",
  "status": "completed",
  "result": {
    "verified": true,
    "verifiedAge": 25
  }
}

In a real integration you would send the user to sessionUrl or redirectUrl to complete verification, then poll status or use webhooks instead of polling.

Step 4 (optional): Validate a token

When the user completes the session, you may receive a token (e.g. in a redirect or callback). Validate it on your backend:

curl -s -X POST https://api.loomapi.com/tokens/validate \
  -H "x-tenant-api-key: $LOOM_TENANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "YOUR_TOKEN_FROM_SESSION"}'

This confirms the verification result server-side. See Verification for full request/response details.

Summary

All API requests use the x-tenant-api-key header. Base URL: https://api.loomapi.com.

Next steps

• Authentication — tenant key vs console (Clerk)
• Key Management — show-once, rotate, revoke
• Verification — full reference for start, status, tokens
• Billing & Usage — how usage is counted and quotas
• Webhooks — receive verification events without polling
• Examples — more curl and Node.js samples