TermsPrivacyAcceptable useData sourcesRemoval request
LeadIntelQuickstartAPI referenceScopesErrorsopenapi.json

API errors

Errors are application/problem+json (RFC 9457). The type of each problem links to its entry here; branch on the stable code, never on detail.

CodeStatusMeaning
bad_request400The request is malformed or breaks a rule that is not a field validation, for example an unreadable cursor or a missing Idempotency-Key header.
unknown_plan400The plan key does not exist.
invalid_webhook_signature401A provider webhook callback failed signature verification and was ignored.
unauthorized401The credential is missing, invalid, expired or revoked.
insufficient_credits402The workspace balance cannot cover the credits this action reserves. Top up or reduce the request.
email_not_verified403The action needs a verified email address; verify it and retry.
forbidden403The credential is valid but lacks the scope the route requires, or a CSRF token is missing on a session request.
sandbox_unsupported403A test key (li_test_) cannot call this route; use a live key or the web app. Test keys reach only searches, enrichments, lookups and events.
signup_invite_only403Open signup is disabled on this deployment; ask a workspace admin for an invitation link.
tenant_suspended403The workspace is suspended or being deleted; every credential of that tenant is refused until a platform admin reactivates it.
http_404404No route matches the path.
not_found404The resource does not exist in this tenant. Resources of other tenants are reported the same way.
organization_not_found404No organization matches the id or lookup criteria.
http_405405The route does not support this HTTP method.
billing_not_configured409No payment provider is configured for this deployment (`LI_BILLING_PROVIDER=none`); use manual invoicing through the admin credit API.
checkout_unavailable409The workspace is deleting or was suspended by a platform admin, so it cannot start a checkout; only active or billing-suspended workspaces can pay.
conflict409The request conflicts with current state, for example a duplicate name.
debit_exceeds_balance409A credit debit would take the balance below zero.
deletion_grace_expired409The deletion grace period is over; the deletion cannot be cancelled.
deletion_not_pending409There is no pending deletion to cancel.
idempotency_in_progress409A request with this Idempotency-Key is still running; retry after a short delay.
idempotency_key_reused409The Idempotency-Key was already used on this route with a different body. Use a new key for a different request.
idempotency_secret_already_issued409The original request issued a one-time secret that is never replayed. Create a new resource with a new key.
removal_needs_mapping409The removal request names free text, a shared or free-mail domain, or no registrable domain, or a person request by email or phone names no person_ids, so it cannot be applied automatically; map it to an organization id, a company domain or the person's per_ ids (person_ids in the approve body), or reject it.
tenant_deleting409The tenant is being deleted and cannot be changed this way.
http_413413The request body exceeds the size limit.
upload_too_large413The uploaded file is larger than the plan's upload size limit.
http_415415The Content-Type is not supported; send `application/json`.
unsupported_media_type415The upload's `Content-Type` differs from the type declared when the upload was created.
validation_error422A body, path or query field failed validation. `errors` lists each field with its location and message.
job_limit_exceeded429The workspace already runs its plan's maximum of concurrent bulk jobs. Wait for one to finish.
rate_limit_exceeded429Too many requests. Wait for `Retry-After` seconds; see the `RateLimit-*` headers.
internal_error500An unexpected server error. Retry with backoff and quote `request_id` when you contact support.
billing_provider_error502The payment provider rejected or could not complete the request; retry later. No payment was recorded as succeeded.