Get one usage event

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

import requests

url = "https://api.crustdata.com/account/usage/events/{request_id}"

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/events/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "event_id": "678a3646-371d-4f81-b5c3-488fdda81e21",
  "ts": "2026-09-24T03:24:40.229000+00:00",
  "team_id": 1318,
  "user_id": 1318,
  "api_key_id": 170,
  "client_surface": "api",
  "client_platform": "curl",
  "user_agent": "curl/8.7.1",
  "client_ip": "203.0.113.10",
  "product": "person_enrich",
  "endpoint": "/person/enrich",
  "method": "POST",
  "api_version": "2025-11-01",
  "http_status": 200,
  "status_class": "2xx",
  "error_type": "",
  "error_key": "",
  "result_count": 1,
  "latency_ms": 413.3949890136719,
  "credits_used": 2,
  "cost_components": [
    {
      "component": "person.profile",
      "label": "Person enrich (base)",
      "quantity": 1,
      "unit_price": 1,
      "credits": 1
    },
    {
      "component": "person.business_email",
      "label": "Business email",
      "quantity": 1,
      "unit_price": 1,
      "credits": 1
    }
  ],
  "linked_ids": {},
  "request": {
    "body": {
      "fields": [
        "basic_profile",
        "contact.business_emails"
      ],
      "professional_network_profile_urls": [
        "https://www.linkedin.com/in/vinod-keshav-seetharamu/"
      ]
    },
    "path_params": {},
    "query_params": {}
  },
  "headers": {
    "accept": "*/*",
    "apikey": "<redacted>",
    "authorization": "<redacted>",
    "content-length": "151",
    "content-type": "application/json",
    "user-agent": "curl/8.7.1",
    "x-api-version": "2025-11-01"
  },
  "response": null
}

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

{
  "error": {
    "type": "not_found",
    "message": "No usage event with that request id.",
    "metadata": []
  }
}

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

Usage event

Looks up one request by the X-Request-Id header its response carried. Returns every field of an event in GET /account/usage/events plus what was sent:

request: the body, query parameters and path parameters.
headers: the request headers, with authorization and apikey shown as <redacted>.
response: the error body a failed request got back, redacted. It is JSON when the body was JSON, and a string when it was not or was cut at 32 KB. It is null on a success and on a 429.

A request id that belongs to another team returns 404, the same as one that never existed.

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

events

{request_id}

Get one usage event

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

import requests

url = "https://api.crustdata.com/account/usage/events/{request_id}"

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/events/{request_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "event_id": "678a3646-371d-4f81-b5c3-488fdda81e21",
  "ts": "2026-09-24T03:24:40.229000+00:00",
  "team_id": 1318,
  "user_id": 1318,
  "api_key_id": 170,
  "client_surface": "api",
  "client_platform": "curl",
  "user_agent": "curl/8.7.1",
  "client_ip": "203.0.113.10",
  "product": "person_enrich",
  "endpoint": "/person/enrich",
  "method": "POST",
  "api_version": "2025-11-01",
  "http_status": 200,
  "status_class": "2xx",
  "error_type": "",
  "error_key": "",
  "result_count": 1,
  "latency_ms": 413.3949890136719,
  "credits_used": 2,
  "cost_components": [
    {
      "component": "person.profile",
      "label": "Person enrich (base)",
      "quantity": 1,
      "unit_price": 1,
      "credits": 1
    },
    {
      "component": "person.business_email",
      "label": "Business email",
      "quantity": 1,
      "unit_price": 1,
      "credits": 1
    }
  ],
  "linked_ids": {},
  "request": {
    "body": {
      "fields": [
        "basic_profile",
        "contact.business_emails"
      ],
      "professional_network_profile_urls": [
        "https://www.linkedin.com/in/vinod-keshav-seetharamu/"
      ]
    },
    "path_params": {},
    "query_params": {}
  },
  "headers": {
    "accept": "*/*",
    "apikey": "<redacted>",
    "authorization": "<redacted>",
    "content-length": "151",
    "content-type": "application/json",
    "user-agent": "curl/8.7.1",
    "x-api-version": "2025-11-01"
  },
  "response": null
}

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

{
  "error": {
    "type": "not_found",
    "message": "No usage event with that request id.",
    "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"

Path Parameters

request_id

string

required

The X-Request-Id response header of the request, also returned as event_id by GET /account/usage/events.

Maximum string length: 256

Response

The event, with the stored request.

An event plus the request that was stored for it.

event_id

string

required

The request id, the same value as the X-Request-Id header on the original response.

Example:

"678a3646-371d-4f81-b5c3-488fdda81e21"

string

required

When the request was made, ISO 8601 in UTC with a +00:00 offset.

Example:

"2026-09-24T03:24:40.229000+00:00"

team_id

integer

required

Your team's id.

Example:

1318

user_id

integer

required

The user on your team who made the request.

Example:

1318

api_key_id

integer | null

required

The API key that made the request. null when the request is not tied to a key, such as a watch run or a request refused with a 429.

Example:

170

client_surface

string

required

Where the request came from. Values seen today are api, mcp, cli, dashboard, batch, watcher, export, and gateway for a request refused before it reached the API, such as a 429.

Example:

"api"

client_platform

string

required

The client detected from the request, for example python, node, curl or claude-code. It comes from the MCP client tag, the CLI's user agent, or a category based on your User-Agent header. New values can appear at any time. Empty for batch jobs, watches and exports, and usually for requests refused with a 429.

Example:

"curl"

user_agent

string

required

The User-Agent header you sent.

Example:

"curl/8.7.1"

client_ip

string

required

The IP address the request came from.

Example:

"203.0.113.10"

product

string

required

The product the request belongs to, for example person_enrich.

Example:

"person_enrich"

endpoint

string

required

The endpoint, as a route template when it has path parameters, for example /watch/person/:watch_id/runs. The actual values are in request.path_params on the single-event endpoint.

Example:

"/person/enrich"

method

string

required

The HTTP method.

Example:

"POST"

api_version

string

required

The x-api-version header you sent.

Example:

"2025-11-01"

http_status

integer

required

The status code returned.

Example:

200

status_class

string

required

2xx, 3xx, 4xx or 5xx.

Example:

"2xx"

error_type

string

required

The error.type returned on a failure, for example invalid_request. Empty on a success.

Example:

""

error_key

string

required

The error group the request belongs to in GET /account/usage/errors. Empty on a success and on a 429.

Example:

""

result_count

integer | null

required

Results the request returned.

Example:

1

latency_ms

number

required

Time the request took on the server, in milliseconds.

Example:

413.39

credits_used

number

required

Credits charged, the same number the original response returned in X-Credits-Used.

Example:

2

cost_components

object[]

required

The charge lines. Their credits add up to credits_used, and lines charged at 0 credits are kept. Empty when nothing was charged.

Show child attributes

linked_ids

object

required

Ids of the job that made the request, when there is one, such as batch_job_id, watch_id, export_id and export_run_id. Empty for a direct API call.

Show child attributes

Example:

{}

request

object | null

required

What was sent. null when the stored copy is no longer available.

Show child attributes

headers

object | null

required

The request headers, with authorization and apikey shown as <redacted>.

Show child attributes

response

any | null

required

The error body a failed request got back, redacted. JSON when it was JSON, a string when it was not or was cut at 32 KB. null on a success and on a 429.