---
title: "Batch Usage"
method: GET
path: "/api/v1/batch/usage"
tags: ["batch"]
---

# Batch Usage

`GET /api/v1/batch/usage`

## Request

- Base URL: `https://agentictrade.io` (the document declares no server; this is the origin it was published from)
- URL: `https://agentictrade.io/api/v1/batch/usage`
- Auth: none declared

Aggregate API usage across all keys belonging to an owner for a specified date range.

Requires admin authentication.

If period_start and period_end are not provided, defaults to the current calendar month.
Returns total call count, total spend, key count, and the billing period.

## Query parameters

- `owner_id` string, required: Owner ID to aggregate usage for
- `period_start` string, nullable: Start date (ISO 8601, e.g. 2026-01-01). Defaults to first day of current month.
- `period_end` string, nullable: End date (ISO 8601, e.g. 2026-01-31). Defaults to current timestamp.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentictrade/apis/agent-commerce-framework.md) · [All operations](https://skmtc.dev/agentictrade/apis/agent-commerce-framework/llms.txt) · [OpenAPI document](https://skmtc.dev/agentictrade/apis/agent-commerce-framework/revisions/65b4b64609bc?raw)