curl -X GET 'https://api.openai.com/v1/organization/spend_alerts?limit=10&order=asc&after=example-after&before=example-before' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

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

> List organization spend alerts

## 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/spend_alerts?limit=10&order=asc&after=example-after&before=example-before' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| limit | query | integer | No | A limit on the number of spend alerts to return. Defaults to 20. |
| order | query | string | No | Sort order for the returned spend alerts. |
| after | query | string | No | Cursor for pagination. Provide the ID of the last spend alert from the previo... |
| before | query | string | No | Cursor for pagination. Provide the ID of the first spend alert from the previ... |

## Response example
{"object":"list","data":[{}]}

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

GET

GET /organization/spend_alerts — OpenAI API

OpenAI admin key (required); https://api.openai.com/v1

OpenAI API

List organization spend alerts

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 255 tokens · Vary: Accept

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/spend_alerts?limit=10&order=asc&after=example-after&before=example-before' \  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

Parameters

Name	In	Type	Required	Description
limit	query	integer	No	A limit on the number of spend alerts to return. Defaults to 20.
order	query	string	No	Sort order for the returned spend alerts.
after	query	string	No	Cursor for pagination. Provide the ID of the last spend alert from the previous response to fetch the next page.
before	query	string	No	Cursor for pagination. Provide the ID of the first spend alert from the previous response to fetch the previous page.

Response 200 OK

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "organization.spend_alert",
      "threshold_amount": 0,
      "currency": "USD",
      "interval": "month",
      "notification_channel": {
        "type": "email",
        "recipients": [
          "string"
        ],
        "subject_prefix": "string"
      }
    }
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": true
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.