Anthropic's API documentation details a new method for organizations to monitor member spend. This API call returns information about effective spend limits and period-to-date spend for each member, providing a granular view of usage within an organization.
Key Points
- The API returns one row per (member, period) for which a member resolves a spend limit.
- Each row includes the source scope from which the spend limit was inherited.
- Pagination is by member, ensuring a member's periods are not split across pages.
- The default maximum number of members per page is 20.
- Reports can be restricted to specific limit periods or up to 100 members by tagged user ID.
- The effective limit amount is provided as a non-negative integer decimal string in the minor unit of currency (e.g., cents for USD).
nullfor the effective limit amount indicates no limit applies for that specific period.
Context
According to Anthropic's documentation, this API functionality allows organizations to track and manage the financial aspects of their members' usage of Claude models. It provides details such as the user's email address, display name, and whether the account has been deleted, alongside the financial data.
Why It Matters
This API enhancement offers organizations greater transparency and control over their spending on Claude services. Builders can integrate this data into their internal cost management systems, enabling more precise budget allocation and usage monitoring for individual team members.
What To Do
- Review the Anthropic API Reference for the
List Effective Spend Limitsendpoint. - Test the API with different pagination and filtering parameters to understand its behavior.
- Note the currency code (ISO 4217) and the format of spend amounts (minor units, up to three decimal places).
- Consider how to integrate this data into existing financial reporting or user management dashboards.
