GET/organization/projects/{project_id}/spend_limit

Get a project spend limit

Retrieves the hard spend limit configured for a project. Use project_id to identify the project whose limit and enforcement state you want to inspect.

1 parameter
project_idstringrequired
The ID of the project whose hard spend limit to retrieve.

4 status codes
200Returns the project's hard spend limit, including its amount in cents, currency, evaluation interval, and enforcement state.
objectstringrequired
The object type, which is always `project.spend_limit`.
Allowed:project.spend_limitDefault:project.spend_limit
threshold_amountintegerrequired
The hard spend limit amount, in cents.
currencystringrequired
The currency for the threshold amount. Currently, only `USD` is supported.
intervalstringrequired
The time interval for evaluating spend against the threshold. Currently, only `month` is supported.
enforcementobjectrequired
The current enforcement state of the hard spend limit.
400Returned when the project ID is invalid.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404Returned when the project was not found or does not have a hard spend limit.
errorobjectrequired

Error handling

A 400 is returned when the project_id path parameter is invalid. A 403 is returned when the authenticated user does not have permission to manage the project's spend limit. A 404 is returned when the project does not exist or has no configured hard spend limit.