OpenAI API (unofficial showcase)
GET/organization/projects/{project_id}/spend_alerts/{alert_id}

Retrieve a project spend alert

Retrieves a spend alert configured for a project. Use the project and alert identifiers to inspect its threshold, currency, evaluation interval, and notification channel.

2 parameters
project_idstringrequired
The ID of the project containing the spend alert.
alert_idstringrequired
The ID of the spend alert to retrieve.

4 status codes
200Returns the project spend alert, including its ID, threshold amount, currency, interval, and notification channel.
idstringrequired
The identifier, which can be referenced in API endpoints.
objectstringrequired
The object type, which is always `project.spend_alert`.
Allowed:project.spend_alert
threshold_amountintegerrequired
The alert threshold amount, in cents.
currencystringrequired
The currency for the threshold amount.
Allowed:USD
intervalstringrequired
The time interval for evaluating spend against the threshold.
Allowed:month
notification_channelobjectrequired
Email notification settings for a spend alert.
400Returned when the project ID is invalid.
errorobjectrequired
403Returned when the caller does not have permission to retrieve the project spend alert.
errorobjectrequired
Details about the permission error.
404Returned when the project or spend alert is not found.
errorobjectrequired

Error handling

A 400 is returned when the project ID is invalid; a 403 when the authenticated user lacks permission; and a 404 when the project or spend alert is not found. The project_id path parameter and alert_id path parameter must identify the project and alert to retrieve.