Get member credit usage

get

https://api.platform.censys.io/v3/accounts/organizations/{organization_id}/members/{user_id}/credits/usage

Retrieve credit consumption information for an organization member over a specific date range. You must include a start date in your request.

This endpoint does not cost any credits to execute.

Path Params

organization_id

uuid

required

The ID of a Censys organization. See the Getting Started docs for more information.

user_id

uuid

required

The ID of a Censys user. You can obtain a user's ID by listing members of an organization.

Query Params

date

string

deprecated

The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).

start_date

date

The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).

end_date

date

The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).

granularity

string

enum

required

Defaults to daily

Whether to break down credit usage on a daily or monthly basis.

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200OK

400Invalid date format

401Request does not contain a valid Authorization token

403User does not have permission to access this data

404Organization not found

422Invalid user ID or organization ID

500Internal server error