curl --request GET \
--url https://api.orq.ai/v2/budgets \
--header 'Authorization: Bearer <token>'{
"data": [
{
"_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
"type": "contact",
"contact_id": "contact_01ARZ3NDEKTSV4RRFFQ69G5FAV",
"limit_amount": 1000,
"period": "monthly",
"is_active": true,
"created": "2024-01-15T10:30:00Z",
"updated": "2024-01-15T10:30:00Z"
}
],
"has_more": false
}Retrieves a paginated list of budget configurations in your workspace. Supports filtering by type (contact or workspace). For workspace budgets, only one budget can exist per workspace.
curl --request GET \
--url https://api.orq.ai/v2/budgets \
--header 'Authorization: Bearer <token>'{
"data": [
{
"_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
"type": "contact",
"contact_id": "contact_01ARZ3NDEKTSV4RRFFQ69G5FAV",
"limit_amount": 1000,
"period": "monthly",
"is_active": true,
"created": "2024-01-15T10:30:00Z",
"updated": "2024-01-15T10:30:00Z"
}
],
"has_more": false
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10
1 <= x <= 50A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include after=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the next page of the list.
A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include before=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the previous page of the list.
Filter by budget entity type (contact or workspace)
contact, workspace "contact"
Filter by specific entity ID
"contact_01ARZ3NDEKTSV4RRFFQ69G5FAV"
Filter by active status
true
List of budget configurations
list Show child attributes
Unique ULID for the budget configuration
"01ARZ3NDEKTSV4RRFFQ69G5FAV"
Budget entity type
api_key, contact, workspace "contact"
Whether this budget configuration is currently active
true
API Key identifier (present when type is "api_key")
"01ARZ3NDEKTSV4RRFFQ69G5FAV"
Contact external identifier (present when type is "contact")
"user_123"
Show child attributes
Current period consumption in USD
x >= 0125.5
Remaining budget (amount - current_amount)
124.5
When the current period started
"2024-01-01T00:00:00Z"
When the current period will reset
"2024-01-31T23:59:59Z"
The date and time the resource was created
The date and time the resource was last updated
Was this page helpful?