List usage errors

curl --request GET \
  --url https://api.crustdata.com/account/usage/errors \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/account/usage/errors"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/account/usage/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "total_errors": 20,
  "by_kind": {
    "request": 19,
    "account": 0,
    "server": 0,
    "no_results": 1
  },
  "groups": [
    {
      "endpoint": "/person/search",
      "error_key": "<v> must be at least <n>. Got <n>.",
      "kind": "request",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 4,
      "last_seen": "2026-09-23T23:42:53.250000+00:00",
      "example_event_id": "279ad996-cd3e-4856-b230-a95d77a0b715"
    },
    {
      "endpoint": "/job/search",
      "error_key": "Unsupported columns in conditions: [<values>]",
      "kind": "request",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 2,
      "last_seen": "2026-09-23T23:50:58.158000+00:00",
      "example_event_id": "1f695ab5-920f-485c-8014-342e3b3af61a"
    },
    {
      "endpoint": "/screener/person/search",
      "error_key": "No profiles match your search criteria. Please try different search parameters.",
      "kind": "no_results",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 1,
      "last_seen": "2026-09-23T14:52:45.789000+00:00",
      "example_event_id": "8f9aff61-35dd-432e-917a-c607ff820c71"
    }
  ],
  "truncated": false
}

{
  "error": {
    "type": "invalid_request",
    "message": "start: start cannot be more than 12 months ago.",
    "metadata": []
  }
}

{
  "error": {
    "type": "unauthorized",
    "message": "Invalid API key in request.",
    "metadata": []
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded for this endpoint. Please write to gtm@crustdata.co.",
    "metadata": []
  }
}

Usage errors

Groups your team’s failed requests, most frequent first. A group is one endpoint plus one error_key: the error message with your own values masked, for example <v> must be at least <n>. Got <n>.

kind says what to do about a group:

request: change the call.
account: credits or field access. Groups with a 402 or 403.
server: it failed on our side. Retry.
no_results: the request was valid and nothing matched.

Successes and 429 responses never appear here. To see the requests in a group, pass its error_key to GET /account/usage/events, or open example_event_id with GET /account/usage/events/{request_id}.

At most 1000 groups come back. truncated is true when the list was cut, and total_errors and by_kind count only the groups returned.

This endpoint is free: the response carries no X-Credits-Used header. It shares a limit of 60 requests per minute with the other /account/usage/* endpoints.

GET

https://api.crustdata.com

account

usage

errors

List usage errors

curl --request GET \
  --url https://api.crustdata.com/account/usage/errors \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/account/usage/errors"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/account/usage/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "total_errors": 20,
  "by_kind": {
    "request": 19,
    "account": 0,
    "server": 0,
    "no_results": 1
  },
  "groups": [
    {
      "endpoint": "/person/search",
      "error_key": "<v> must be at least <n>. Got <n>.",
      "kind": "request",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 4,
      "last_seen": "2026-09-23T23:42:53.250000+00:00",
      "example_event_id": "279ad996-cd3e-4856-b230-a95d77a0b715"
    },
    {
      "endpoint": "/job/search",
      "error_key": "Unsupported columns in conditions: [<values>]",
      "kind": "request",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 2,
      "last_seen": "2026-09-23T23:50:58.158000+00:00",
      "example_event_id": "1f695ab5-920f-485c-8014-342e3b3af61a"
    },
    {
      "endpoint": "/screener/person/search",
      "error_key": "No profiles match your search criteria. Please try different search parameters.",
      "kind": "no_results",
      "http_status": 400,
      "error_type": "invalid_request",
      "count": 1,
      "last_seen": "2026-09-23T14:52:45.789000+00:00",
      "example_event_id": "8f9aff61-35dd-432e-917a-c607ff820c71"
    }
  ],
  "truncated": false
}

{
  "error": {
    "type": "invalid_request",
    "message": "start: start cannot be more than 12 months ago.",
    "metadata": []
  }
}

{
  "error": {
    "type": "unauthorized",
    "message": "Invalid API key in request.",
    "metadata": []
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded for this endpoint. Please write to gtm@crustdata.co.",
    "metadata": []
  }
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. This endpoint currently requires 2025-11-01. Requests without the header, or with any other value, return 400.

Available options:

2025-11-01

Example:

"2025-11-01"

Query Parameters

start

string

Start of the window, inclusive. An ISO 8601 timestamp such as 2026-09-23T14:00:00Z, or a date such as 2026-09-21, which reads as midnight UTC. Defaults to 7 days before end. Cannot be more than 12 months ago.

end

string

End of the window, exclusive. Same formats as start. Defaults to the coming midnight UTC, so the default window is the last 7 whole days including today.

api_key_ids

integer[]

Keep only requests made with these API key ids (api_key_id on an event). Repeat the parameter or send a comma-separated list, up to 50.

Maximum array length: 50

Required range: x >= 1

endpoints

string[]

Keep only these endpoints, as they appear in endpoint, for example /person/search. Repeat the parameter or send a comma-separated list, up to 50.

Maximum array length: 50

Response

Error groups for the window.

Your team's failed requests, grouped.

total_errors

integer

required

Failed requests across the groups returned.

Example:

20

by_kind

object

required

Failed requests per kind across the groups returned. Every kind is present, at 0 when it has none.

Show child attributes

Example:

{
  "request": 19,
  "account": 0,
  "server": 0,
  "no_results": 1
}

groups

object[]

required

Error groups, most frequent first. At most 1000.

Show child attributes

Example:

[]

truncated

boolean

required

true when more than 1000 groups matched and the list was cut.

Example:

false