BeefAPIEndpoints
Read request records
Look up a request’s charge or page through this key’s usage.
GET
/v1/usage/requestsSend your API key in the Authorization: Bearer YOUR_BEEFAPI_KEY header. Get an API key →
Request example
Use your key. Replace sample task IDs and image URLs.
curl -X GET "https://global.beefapi.com/v1/usage/requests" \ -H "Authorization: Bearer YOUR_BEEFAPI_KEY"Response examples
Illustrative values. Select a status code.
A page of usage records.
{ "currency": "USD", "data": [ { "usage_estimated": true, "id": "string", "request_id": "string", "created_at": 0, "model": "string", "result": "completed", "billing_status": "settled", "amount": "string", "reserved_amount": "string", "refunded_amount": "string", "input_tokens": 0, "output_tokens": 0, "cache_read_tokens": 0, "cache_write_tokens": 0, "pricebook_id": "string", "pricing_version": "string" } ], "next_cursor": "string", "has_more": true, "start_time": 0, "end_time": 0}Query Parameters
| Parameter | Description |
|---|---|
start_time | Inclusive Unix timestamp. Defaults to 30 days before end_time. Minimum: Format: |
| Parameter | Description |
|---|---|
end_time | Exclusive Unix timestamp. Defaults to now. Maximum window: 31 days. Minimum: Format: |
| Parameter | Description |
|---|---|
model | Exact model ID. Max. characters: |
| Parameter | Description |
|---|---|
request_id | Match a recorded request or its linked funding receipt. Max. characters: |
| Parameter | Description |
|---|---|
limit | Default: Minimum: Maximum: |
| Parameter | Description |
|---|---|
before | next_cursor from the previous page. Keep the same time window and filters. |
Response fields & status codes
Response fields
application/json
application/json
application/json
application/json
application/json