Usage

Get Usage

get/v1/usage/

Query parameters

workspace_uuidstring nullable

date_fromstring date nullable

Start date for filtering free user score runs

date_tostring date nullable

End date for filtering free user score runs

billing_cycle_uuidstring nullable

Specific billing cycle UUID to retrieve

Response

test_type_displaysobject required

Changes

Changed in 3 of the 25 revisions of this API.11020

Oct 29, 20259b529d67a7d011015See the full diff
- ▲
  removed the required property billing_cycles/anyOf[subschema #1]/items/score_runs from the response with the 200 status
  response-required-property-removed
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 409
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 422
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new auth.workspace_required enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new video enum value to the free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the new optional query request parameter billing_cycle_uuid
  new-optional-request-parameter
- ○
  added the new optional query request parameter date_from
  new-optional-request-parameter
- ○
  added the new optional query request parameter date_to
  new-optional-request-parameter
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/balance_remaining to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/credits_available to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/credits_used to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/pricing_rules_count to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/total_usage to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/usage_breakdown to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property billing_cycles/anyOf[subschema #1]/items/workspace_groups to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property free_score_runs/anyOf[subschema #1]/items/created_by/anyOf[subschema #1: UserOutSchema]/org_admin_emails to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property free_score_runs/anyOf[subschema #1]/items/created_by/anyOf[subschema #1: UserOutSchema]/workspace to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property free_score_runs/anyOf[subschema #1]/items/workspace_name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property free_score_runs/anyOf[subschema #1]/items/workspace_uuid to the response with the 200 status
  response-optional-property-added
- ○
  added the required property billing_cycles/anyOf[subschema #1]/items/pricing_model to the response with the 200 status
  response-required-property-added
May 6, 202539873621da544See the full diff
- ○
  removed the audio enum value from the billing_cycles/anyOf[subschema #1]/items/score_runs/items/test/modality/allOf[subschema #1: ContentType]/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the audio enum value from the free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the video enum value from the billing_cycles/anyOf[subschema #1]/items/score_runs/items/test/modality/allOf[subschema #1: ContentType]/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the video enum value from the free_score_runs/anyOf[subschema #1]/items/test/modality/allOf[subschema #1: ContentType]/ response property for the response status 200
  response-property-enum-value-removed
May 6, 2025b9afd900cfb11See the full diff
- ○
  removed the multiturn_safety enum value from the test_type_displays/propertyNames/ response property for the response status 200
  response-property-enum-value-removed
This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history