List usage by tool

Retrieves paginated per-tool credit usage over the given time window

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

end_timedatetimeRequired

End of the usage window (ISO 8601 with timezone, e.g. 2026-04-30T00:00:00Z)

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

start_timedatetimeRequired

Start of the usage window (ISO 8601 with timezone, e.g. 2026-04-01T00:00:00Z)

countinteger

resultslist of objects

nextstring or nullOptionalformat: "uri"

previousstring or nullOptionalformat: "uri"

last_updated_atdatetime or nullOptional

When usage data was last refreshed. Usage is aggregated periodically, so the most recent tool calls may not be included yet.

$	curl -G https://ah-api.merge.dev/api/v1/usage/tools/ \
>	-H "Authorization: Bearer <token>" \
>	-d end_time=end_time \
>	-d start_time=start_time

1	{
2	"count": 123,
3	"results": [
4	{
5	"connector": "string",
6	"tool_name": "string",
7	"credits_used": 1,
8	"call_count": 1
9	}
10	],
11	"next": "https://ah-api.merge.dev?page=4",
12	"previous": "https://ah-api.merge.dev?page=2",
13	"last_updated_at": "2024-01-15T09:30:00Z"
14	}