# GET /organization/usage/decisions (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI admin key; required.
Last verified: 2026-10-20

> Decisions

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X GET 'https://api.openai.com/v1/organization/usage/decisions?start_time=10&end_time=10&bucket_width=1m&limit=10&page=example-page&project_ids=example&group_by=example&user_ids=example&api_key_ids=example&models=example&batch=true' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| start_time | query | integer | Yes | Start time (Unix seconds) of the query time range, inclusive. |
| end_time | query | integer | No | End time (Unix seconds) of the query time range, exclusive. |
| bucket_width | query | string | No | Width of each time bucket in response. Currently `1m`, `1h` and `1d` are supp... |
| limit | query | integer | No | Specifies the number of buckets to return. - `bucket_width=1d`: default: 7, m... |
| page | query | string | No | A cursor for use in pagination. Corresponding to the `next_page` field from t... |
| project_ids | query | string[] | No | Return only usage for these projects. |
| group_by | query | string[] | No | Group the usage data by the specified fields. Support fields include `project... |
| user_ids | query | string[] | No | Return only usage for these users. |
Other params: api_key_ids, models, batch

## Response example
{"object":"page","has_more":true}

---
Need an API key? Get one at https://platform.openai.com/api-keys