CEcensys
Account Management

Get Free user credit usage

Retrieve your Free user account credit consumption information over a specific date range. You must include a start date in your request.<br><br>This endpoint does not cost any credits to execute.

get/v3/accounts/users/credits/usage

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v3/accounts/users/credits/usage
  • Auth
    HTTP bearer

Query parameters

datestring

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).

Example:2025-11-01
start_datestring 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).

Example:2025-11-01
end_datestring 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).

Example:2025-12-01
granularity'daily' | 'monthly' required

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

Example:daily

Response

OK

Example response

{
  "result": {
    "credits_consumed_by_consumer": {
      "user@example.com": 3000
    },
    "granularity": "daily"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.