Get credit usage for agents in a space
Get credit usage for agents in a space.
workflows:read
credits_used_by_type breaks usage down into Notion, Select, and Standard credits. Learn what each credit type covers. credits_used counts only Notion credits, so the credits in credits_used_by_type don’t add up to credits_used.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The Admin API version to use for this request.
2026-06-01 Path Parameters
Query Parameters
next_cursor from a previous response, to fetch the next page of agents. Nested cursors continue one agent's billing periods through the single-agent endpoint.
Deprecated alias for start_cursor. If both are set, they must match.
Number of agents per page. Defaults to 100, maximum 100.
1 <= x <= 100Set to "true" to include soft-deleted and permanently deleted agents with retained credit usage; included deleted agents have status "deleted". Omit this parameter or set it to "false" to return only live agents.
false, true Epoch ms, inclusive. When either bound is set, an agent is returned only if its latest credit usage is inside the [from, to] window; agents with no in-window usage are excluded entirely, and last_credit_usage_time on each result reflects the most recent credit usage within the window.
Epoch ms, inclusive. See credit_usage_time_from for the window semantics.
Response
Always list
"list"Always agent_credit_usage
"agent_credit_usage"Whether more agents are available.
The page of agents with their credit usage, up to 100 agents per request. Every agent starts at its most recent billing period; a nested result's next_cursor paginates that agent's billing periods through the single-agent credit-usage endpoint.
Cursor to pass as start_cursor on the next request to fetch the next page of agents; null when has_more is false.