Metered credit-header & skip-trace API. Prepaid credits, per-key rate limits.
Authorization: Bearer tlo_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
| Endpoint | Cost |
|---|---|
| POST /v1/lookup | 1 credit (only when rows are returned) |
| POST /v1/lookup/bulk | 1 credit per subject that returns rows |
| POST /v1/ssn/unlock | free |
| GET /v1/balance, /v1/usage, /v1/me, /v1/pricing | free |
| POST /v1/credit/pull | 5 credits |
curl -X POST https://YOUR-HOST/v1/lookup -H "Authorization: Bearer $TLO_KEY" -H "Content-Type: application/json" -d '{"last":"WOMACK","first":"ZIYONNA","state":"PA"}'
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/health | liveness (public) |
| GET | /v1/pricing | costs and data packages |
| GET | /v1/balance | remaining credits |
| GET | /v1/usage | your call history |
| GET | /v1/me | key status |
| POST | /v1/lookup | single search |
| POST | /v1/lookup/bulk | up to 100 subjects |
| POST | /v1/ssn/unlock | decrypt ssnEncrypted |
| POST | /v1/credit/pull | TU / EFQ report |
last first middle ssn dob
phone address city state zip
limit (max 25) decrypt age_min age_max
| Code | error |
|---|---|
| 400 | bad_request |
| 401 | invalid_or_revoked_key |
| 402 | insufficient_credits |
| 429 | rate_limited (Retry-After) |
| 502 | upstream_error |
Credits are prepaid and debited atomically. A lookup that returns zero rows is not charged.
Top up by contacting your account manager; balance is always visible at /v1/balance.
OpenAPI spec: /v1/openapi.json