Docs menu

Errors

Every failure returns an HTTP error status and the same small body, so one handler covers them all:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your balance doesn't cover this call.",
    "request_id": "0d3b7c1e-5f8a-4c2e-9b6d-2a1f4e7c9d10"
  }
}

Switch on code: it never changes. The message is a plain sentence you can show to a person, and the request_id (also in the X-Request-Id header) helps us find the call if you contact support. You weren't charged for any error. When a status comes with a Retry-After header, wait that many seconds before trying again.

Your request

StatusCodeWhat it meansWhat to do
400invalid_domainThe domain or host isn't a valid name.Check the spelling; send a name like example.com, not a full address with spaces.
400invalid_urlThe URL can't be checked: not http or https, a port other than 80 or 443, or an IP address.Send a public https:// address, or just the domain.
400invalid_requestA parameter is missing or wrong, or an X-Request-Id was already used for a different call.Read the message: it names the field. Send a new request ID for a new call.
422invalid_requestA report sent through the security page holds control characters, so it can't be stored.Remove them (new lines and tabs are fine) and send it again.
400unsupported_tldThis tool can't check names under that TLD (the registry publishes no data).See TLD coverage; a DNS lookup still works.
400private_key_refusedThe certificate decoder was sent something holding a private key. It was refused before reading it.Send only the certificate or the CSR. Never paste a private key anywhere.
400export_too_largeThe report is too big to turn into a PDF.Export it as JSON or CSV instead, or split the job.
400token_invalidA sign-in link, invite or passkey answer is unknown, used or expired.Ask for a new link or invite.
404not_foundNothing at this path, or a job, stream, monitor or export that doesn't exist, has expired or isn't yours.Check the ID and the address against the API reference.
405method_not_allowedThe endpoint doesn't take that HTTP method.Check the method in the reference.

Your key and your account

StatusCodeWhat it meansWhat to do
401unauthorizedThe API key is missing, unknown or revoked, or its creator left the account.Send Authorization: Bearer <key> with a current key. See authentication.
402insufficient_creditsYour balance doesn't cover the call's price. Nothing ran.Top up on pricing, or wait for next month's credits.
403account_suspendedThe account is suspended.Contact support.
403sign_in_requiredThis needs an account; it was called without one.Call it with an API key, or sign in on the website.
403challenge_requiredA free check on the website came without its proof-of-work.Let the page finish loading with JavaScript on, then try again.
403forbiddenYour role in this account doesn't allow it (owner-only actions).Ask an owner of the account.
403plan_limitYour plan doesn't allow this: more seats, keys or members than it includes.Upgrade the plan, or remove something first.
403plan_kindYour plan doesn't include this kind of monitor.Pick a kind your plan includes, or upgrade.
403interval_not_allowedYour plan doesn't allow checks this often.Choose a longer interval, or upgrade.
403channel_not_allowedYour plan doesn't include this alert channel type.Use email alerts, or upgrade.
403bulk_lockedBulk checks unlock after your first credit purchase or plan.Buy a pack or a plan, then try again.
403verification_requiredLarge bulk jobs on these domains need proof that you control them.Add the TXT record from POST /v1/verifications/record, then check it.
403reauth_requiredDeleting data needs a sign-in within the last 10 minutes.Sign in again, then repeat the request.
403password_requiredThe shared report has a password.Ask the person who shared it for the password.

Conflicts

StatusCodeWhat it meansWhat to do
409conflictThe request clashes with the current state, such as a second subscription.Read the message, then reload what you have.
409sole_ownerYou are the only owner of an account that has other members.Remove the members, or delete that account first.
409duplicate_monitorYou already have this monitor.Edit the existing monitor instead.
409alerts_offAlert sending is paused on this server, so test sends and webhook checks wait.Try again later.
409no_membersAn account without members has no default alert channel.Add an alert channel first.
409channel_limitThe account already has the most alert channels it can have.Remove one you no longer use.
409channel_unverifiedThe webhook hasn't answered its verification yet.Verify the channel, then attach it. See webhooks.

Limits and busy services

StatusCodeWhat it meansWhat to do
429rate_limitedToo many requests for this key or option.Wait for Retry-After. See rate limits.
429free_limit_reachedA website visitor used today's free checks.Make a free account, or wait until tomorrow (UTC).
429too_many_jobsYour account started too many browser or crawl jobs this hour.Wait for Retry-After, or combine targets into one job.
503busyToo many live result streams are open right now.Retry in a few seconds, or call the tool without streaming.
503site_busyThe site you're checking is getting many checks right now.Retry after 30 seconds.
503browser_busyAll browser sessions are in use.Retry after Retry-After.
503crawl_busyToo many link checks are running site-wide.Retry after Retry-After.
503bulk_busyToo many bulk jobs are running site-wide.Retry after Retry-After.
503lookalike_busyToo many lookalike checks are running site-wide.Retry after Retry-After.
503export_busyThe PDF store is full for now.Retry after Retry-After, or export as JSON or CSV.
503billing_unavailablePayments aren't available right now.Try again later; your credits and plan are unaffected.

Sources and our side

StatusCodeWhat it meansWhat to do
502source_unavailableEvery source the check needs failed to answer (a DNS server, a registry or the site).Retry later; a Retry-After header says when, if we know.
503source_unavailableThe tool is paused for now, for example while its data refreshes.Retry after Retry-After.
500internal_errorSomething went wrong on our side.Retry in a minute; if it keeps happening, contact support with the request ID.