Skip to main content
GET
/
api
/
v1
/
billing
/
agents
/
{agentId}
/
runs
Get individual run costs for a specific agent
curl --request GET \
  --url https://api.example.com/api/v1/billing/agents/{agentId}/runs \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {
      "runId": 123,
      "date": "2023-11-07T05:31:56Z",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "cost": 123,
      "billingType": "<string>"
    }
  ],
  "totalRecordCount": 123,
  "totalCost": 123,
  "agentId": 123,
  "agentName": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key authorization header. Example: "Authorization: ApiKey {your-api-key}"

​
Authorization
string
header
required

OAuth 2.0 Bearer token. Example: "Authorization: Bearer {access-token}"

Path Parameters

​
agentId
integer<int32>
required

The agent ID

Query Parameters

​
startDate
string<date-time>

Start date for the range (ISO format, required)

​
endDate
string<date-time>

End date for the range (ISO format, required)

​
pageIndex
integer<int32>
default:1

Page number (1-based, default: 1)

​
recordsPerPage
integer<int32>
default:50

Records per page (default: 50, max: 1000)

​
sortColumn
string
default:date

Column to sort by: date, cost, duration

​
sortOrder
integer<int32>
default:0

Sort order: 0 = ascending (default), 1 = descending

​
usageTypes
string

Filter by usage types (comma-separated)

Response

Returns the paginated list of runs with costs

Paginated response for agent runs

​
runs
object[] | null

List of runs with their costs

​
totalRecordCount
integer<int32>

Total number of runs matching the filter

​
totalCost
number<double>

Total cost across the runs in the current page. Note: this is a page-level sum, not a grand total across all pages.

​
agentId
integer<int32>

Agent ID

​
agentName
string | null

Agent name