Set up AI Token Spend Management
Overview
AI Token Spend Management gives your finance team consolidated visibility into token usage, costs by model, and spend trends across AI providers like Anthropic and OpenAI. Instead of reconciling invoices from multiple dashboards, you can track it all in one place on Ramp.
If your business uses Ramp only for AI Token Spend Management, see AI Token Spend Management for standalone businesses. That experience has different access and navigation.
Getting started
In the Ramp app, go to Manage Spend > Tokens.
Connect AI providers to AI Token Spend Management
Connect a provider so Ramp can load its cost and usage data. Follow the guide that matches the provider account you use:
- Connect Anthropic Platform (Claude API)
- Connect Claude Enterprise (Claude.ai)
- Connect OpenAI Platform
- Connect ChatGPT Enterprise
- Connect Cursor
- Connect Google Cloud (Gemini)
Who can access AI Token Spend Management
Access to AI Token Spend Management varies by role:
| Role | View company-wide data | Manage settings, API keys, and provider connections | Manage Spend Limits |
|---|---|---|---|
| Owner | Yes | Yes | Yes |
| Admin | Yes | Yes | Yes |
| IT Admin | Yes | Yes | No |
| Finance Admin | Yes | No | No |
| View-Only Admin | Yes | No | No |
| AI Token Spend Admin Custom Role (Plus only) | Yes | Yes | Yes |
To add a user to the AI Token Spend Admin role, go to Company > People and select Edit Profile or Invite People. Under Additional Roles, select AI Token Spend Admin.
Employees with access to their own AI Spend data can view it from My AI Spend after their business completes AI Token Spend onboarding. They cannot access company-wide data or settings.
If you have multiple keys per provider
- Settings → Manage → Add API key
- Once connected, the AI Spend page will load with the additional data
AI Token Spend Management data and sync details
| Detail | Description |
|---|---|
| Sync frequency | Data syncs daily. Expect data to reflect T-1 day. |
| Initial backfill | Up to 24 hours depending on account size and provider rate limits (Anthropic rate limits are currently 1 request per minute). |
| Cost calculation | Ramp pulls costs and usage from your API provider and rationalizes the two data sets. If you have custom rates or credits, reach out so we can reflect that in the calculation. |
Troubleshoot missing or unexpected AI Token Spend data
AI Token Spend Management displays usage and cost data exposed by the provider connection. Data syncs daily and normally reflects T-1 day. A new connection can take up to 24 hours to complete its initial backfill, and larger Anthropic accounts can take longer because of provider rate limits.
Check the provider connection and data source
Use the connection guide that matches the provider product that generated the missing usage. Anthropic Platform (Claude API) and Claude Enterprise (Claude.ai) are separate connections, as are OpenAI Platform and ChatGPT Enterprise. Google Cloud data comes from the Cloud Billing export for the selected billing account, which covers only projects paid by that account.
For ChatGPT Enterprise, the API key's organization must match the ChatGPT workspace organization, and it must include codex.enterprise.analytics.read and chatgpt.enterprise.usage_limit.read. If you plan to use Ramp to control workspace usage limits, it must also include chatgpt.enterprise.usage_limit.write. For Anthropic Platform and OpenAI Platform, personal accounts cannot connect.
Check how usage is attributed
Ramp can display provider-provided reporting dimensions such as user, email address, internal user or team label, API-key label, provider, and model. A breakdown is available only when the connected provider exposes the relevant identifier or dimension in its usage export.
Get help with unresolved data differences
If the expected refresh window has passed and the connection guide confirms the correct provider account and credentials, contact Ramp Support. Include the provider, connected account type, affected date range, and the missing or unexpected provider, user, or API-key data.
Security and data handling
Ramp takes the security of your provider credentials and usage data very seriously.
Credential storage
Ramp stores the API keys you provide for Anthropic, OpenAI Platform, and ChatGPT Enterprise in an encrypted format consistent with Ramp's existing integration security standards. Decrypted keys are not stored by Ramp; we decrypt your key when the system calls the relevant provider API. For GCP, Ramp stores only the BigQuery billing table ID you provide — Ramp does not store any GCP credentials.
Access control
Access to AI Token Spend data and provider administration is role- and permission-based. See Who can access AI Token Spend Management for the current access scopes.
Data minimization
AI Token Spend Management is designed to ingest the fields needed to power spend reporting and analytics and does not require you to provide prompts or message content.
How the product works
For Anthropic Platform and OpenAI Platform, AI Token Spend Management uses the Admin API keys you provide to call the provider's Admin APIs. For ChatGPT Enterprise, Ramp uses an Admin API key with Codex analytics API read access to import usage and billing-related data, such as token usage, cost, provider and model identifiers, and provider-provided reporting dimensions. Ramp uses chatgpt.enterprise.usage_limit.read to read workspace usage-limit settings. If you plan to use Ramp to control those limits, it also uses chatgpt.enterprise.usage_limit.write to change them. For GCP, Ramp reads cost and usage data directly from the BigQuery billing export table you configure — no API key is involved.
Retention
Ramp retains imported spend/usage data to provide historical reporting and trend analysis. If you disconnect a provider, Ramp will cease imports from that provider. For Anthropic and OpenAI, the API key will be immediately hard deleted from our storage. For GCP, the stored billing table ID will be deleted. Any retained usage data will follow Ramp's standard retention and deletion practices.
Manage AI Token Spend after setup
Investigate unexpected activation or invitations
Connecting your first provider creates an AI Token Spend Admin role for your business, but it does not by itself send Ramp invitations. If you see an unexpected pending invitation, review it from Pending invites and delete it to revoke access before it is accepted.
The AI Token Spend Activity tabs record the actor and timestamp for user Spend Limit changes and API-key controls, such as locks and unlocks. They do not provide activation or provider-connection history. Admins and Owners on Ramp Plus can also search the Ramp Audit Log by actor, date and time range, and relevant keywords. The Audit Log does not track every administrative action, including some integration setup events, so do not rely on it as a complete activation or provider-connection history.
Controlling your access
For Anthropic and OpenAI Platform, you can revoke the API key you provided to Ramp at any time to block access to your data. Revoke the key from the OpenAI Console or Claude Console. For ChatGPT Enterprise, revoke the Admin API key from Credentials > Admin keys in the ChatGPT Admin Console. For Cursor, revoke the Admin API key from the Cursor dashboard. For GCP, you can revoke Ramp's access by removing the billing table ID from Ramp or revoking Ramp's read permissions on the dataset in the Google Cloud console.
Frequently asked questions
What data does Ramp import from my AI providers?
Ramp imports usage and cost data exposed through the provider APIs you connect. For example: token usage, spend/cost, provider/model identifiers, and time-based usage metrics. This data is used to power spend reporting and analytics in AI Token Spend Management.
Does Ramp ingest prompts, message content, or model outputs?
AI Token Spend Management is designed for spend and usage reporting and does not require prompts or message content. Ramp uses provider APIs to import usage and cost information rather than application content.
Is any of this personal data?
Typically, the imported data is business account usage and cost data. Depending on your provider configuration, the usage export may include identifiers like a user name, email address, or internal user/team label. If present, Ramp uses those identifiers only to provide spend breakdowns and access-controlled reporting.
How does Ramp use this data?
Ramp uses imported usage/cost data to provide reporting, trend analysis, and cost allocation insights inside AI Token Spend Management. Aggregated or anonymized information may be included in Ramp reports or benchmarks, unless this is precluded by your company's agreement with Ramp. Other Ramp customers do not see your company's provider-level, model-level, team-level, user-level, or API key-level data.
Can Ramp employees see my usage data?
Access is restricted and role-based. Only authorized personnel may access customer data for limited purposes such as support, troubleshooting, and maintaining the service, consistent with Ramp's access controls and logging practices.
How long does Ramp retain this data?
Ramp retains imported data to provide historical reporting and trend analysis. Data retention and deletion follow Ramp's standard practices and contractual obligations.
Does Ramp use this data to train AI models?
AI Token Spend Management uses your provider data to display reporting and analytics. Ramp does not use your company's provider credentials to perform actions in your provider account beyond retrieving usage and cost data, except when you use Ramp to control ChatGPT Enterprise workspace usage limits. In that case, Ramp uses chatgpt.enterprise.usage_limit.read to read settings and chatgpt.enterprise.usage_limit.write to change them.
Can other Ramp customers see my company's AI usage data?
No. Other customers do not see your company's provider-level, model-level, team-level, user-level, or API key-level data.
How does Ramp aggregate and de-identify AI spend data for benchmarks?
Ramp may use aggregated and anonymized customer data to report industry-level AI spending trends and benchmarks. Benchmark reporting is not intended to identify your business, individual users, API keys, or provider account details.
Why is my data taking a long time to load?
Anthropic rate limits are currently 1 request per minute, so larger accounts may take longer to import. We recommend waiting overnight for the initial data load to complete in the background.
How are costs calculated?
Ramp pulls both cost and usage data from your API provider and cross-references them. If you have custom pricing or credits with your provider, reach out to us so we can reflect those in the calculation.
How often does data sync?
Data syncs daily and should be up to date with T-1 day.
What permissions are needed?
Anthropic Platform and OpenAI Platform require an Admin API key limited to read-only permissions for the provider endpoints needed to retrieve usage and billing data. ChatGPT Enterprise requires an Admin API key with Codex analytics API set to Read and chatgpt.enterprise.usage_limit.read. If you plan to use Ramp to control workspace usage limits, also grant chatgpt.enterprise.usage_limit.write. Ramp uses the read scope to read usage-limit settings and the write scope to change them. For GCP, you need Billing Account Costs Manager or Billing Account Administrator on the billing account, plus BigQuery User on the dataset project.