Ramp: List provider API keys and their estimated spend — response body — data item
List provider API keys and their estimated spend: response body, field data / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: List provider API keys and their estimated spend — response body — data item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A provider API key tracked for AI spend. Estimated cost applies to the requested period. All other fields reflect current metadata, not state as of the requested dates. |
active_spend_limit | JSON | Required within parent | |
active_spend_limit (anyOf 1) | Model | Alternative | Expand List provider API keys and their estimated spend — response body — data / item / active_spend_limit / interval: annual, daily, monthly, quarterly, tertiary, total, weekly, yearly Currently active configured spend limit. Its amount and reset cadence are independent of the requested historical dates. Null when the API key has no active spend limit. |
active_spend_limit (anyOf 2) | null | Alternative | |
estimated_cost | Model | Required within parent | Expand Fetch a payment — response body — amount Cost estimated by Ramp for usage attributed to the API key during the requested period. Zero when no usage was attributed. Read only: true |
external_id | string | Required within parent | API key identifier assigned by the provider. |
id | string | Required within parent | Unique identifier of the API key. Format: uuid |
name | JSON | Required within parent | |
name (anyOf 1) | string | Alternative | API key name reported by the provider. |
name (anyOf 2) | null | Alternative | |
owner | JSON | Required within parent | |
owner (anyOf 1) | Model | Alternative | Expand List provider API keys and their estimated spend — response body — data item owner email, first name, id, last name Owner identified by Ramp or the provider. Read only: true |
owner (anyOf 2) | null | Alternative | |
provider | string | Required within parent | Provider that issued the API key. Known values: ANTHROPIC, OPENAI, RAMP Read only: true |
provider_created_at | JSON | Required within parent | |
provider_created_at (anyOf 1) | string | Alternative | Date and time the provider created the API key. Format: date-time |
provider_created_at (anyOf 2) | null | Alternative | |
provider_key_hint | JSON | Required within parent | |
provider_key_hint (anyOf 1) | string | Alternative | Redacted API key hint reported by the provider. |
provider_key_hint (anyOf 2) | null | Alternative | |
provider_last_used_at | JSON | Required within parent | |
provider_last_used_at (anyOf 1) | string | Alternative | Date and time the provider last recorded usage. Format: date-time |
provider_last_used_at (anyOf 2) | null | Alternative | |
status | JSON | Required within parent | |
status (anyOf 1) | string | Alternative | Current API key status, when available from the provider. Known values: active, expired, locked, terminated |
status (anyOf 2) | null | Alternative | |
synced_at | string | Required within parent | Date and time Ramp last synchronized the API key. Format: date-time |
tags | array | Required within parent | Active tags assigned to the API key. |
tags[] | Model | Each item | Expand List provider API keys and their estimated spend — response body — data item tags item |
Referenced models: List provider API keys and their estimated spend — response body — data item owner email, first name, id, last name, List provider API keys and their estimated spend — response body — data item tags item, List provider API keys and their estimated spend — response body — data / item / active_spend_limit / interval: annual, daily, monthly, quarterly, tertiary, total, weekly, yearly, Fetch a payment — response body — amount