Read usage Moderations.

Contract-preserving GET Endpoint for usage Moderations in the OpenAI API. Model and resource-specific values are supplied by the caller at runtime.

All 288 OpenAI Platform REST endpoints from a fixed MIT-licensed official revision, including typed SSE streaming and Realtime call management. Hub provides documentation and an independent SDK/CLI, but never proxies model, account, or usage data; callers connect directly with local API keys.

Request

operationId: usageModerations
Server: https://api.openai.com/v1
Authentication: ApiKeyAuth, AdminApiKeyAuth

Request parameters

`start_time`

queryintegerrequired

start time value in the OpenAI API contract.

`end_time`

queryinteger

end time value in the OpenAI API contract.

`bucket_width`

querystring

bucket width value in the OpenAI API contract.

`project_ids`

queryarray

project ids value in the OpenAI API contract.

`user_ids`

queryarray

user ids value in the OpenAI API contract.

`api_key_ids`

queryarray

api key ids value in the OpenAI API contract.

`models`

queryarray

models value in the OpenAI API contract.

`group_by`

queryarray

group by value in the OpenAI API contract.

`limit`

queryinteger

limit value in the OpenAI API contract.

`page`

querystring

page value in the OpenAI API contract.

Responses

`200`

UsageResponseapplication/json

Successful supplier response.

Properties: datahas_morenext_pageobject

`429`

ErrorResponseapplication/json

Supplier response with HTTP status 429.

Properties: error

{
  "data": {
    "end_time": 0,
    "object": "bucket",
    "results": [],
    "start_time": 0
  },
  "has_more": false,
  "object": "page"
}