---
title: "list llm key requests"
method: GET
path: "/llm_keys/{id}/requests"
tags: ["LlmKeys"]
---

# list llm key requests

`GET /llm_keys/{id}/requests`

## Request

- Base URL: `https://api.aptible.com`
- URL: `https://api.aptible.com/llm_keys/{id}/requests`
- Auth: API key in header `Authorization`

Returns a paginated list of API requests made with the specified LLM key.

## Path parameters

- `id` integer, required

## Query parameters

- `start_time` string, required
- `end_time` string, required
- `page` integer
- `per_page` integer
- `request_id` string
- `status` string
- `model` string
- `sort_by` string
- `sort_order` string
- `no_embed` boolean

## Headers

- `Prefer` 'no_sensitive_extras=true'

## Response `200`

successful

- GetLlmKeyRequests200Response
  - `_embedded` GetLlmKeyRequests200ResponseEmbedded
    - `requests` GetLlmKeyRequests200ResponseEmbeddedRequestsInner[]
      - `_id` string
      - `status` string
      - `start_time` string
      - `end_time` string
      - `model` string
      - `input_tokens` integer
      - `output_tokens` integer
      - `spend` number
  - `total_count` integer
  - `per_page` integer
  - `current_page` integer
  - `_links` GetLlmKeyRequests200ResponseLinks
    - `self` GetLlmKeyRequests200ResponseLinksSelf
      - `href` string
    - `next` GetLlmKeyRequests200ResponseLinksSelf
      - `href` string
    - `prev` GetLlmKeyRequests200ResponseLinksSelf
      - `href` string

## Other responses

- `403`: organization not enrolled
- `404`: not found
- `422`: validation error
- `default`: Error response. Often a 4xx or 5xx status code

## Changes

- **2026-07-24** `1dc1e5b8c6eb`: 2 info
  - added the new optional `header` request parameter `Prefer`
  - added the new optional `query` request parameter `no_embed`
- **2026-07-15** `5c71f4c63067`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aptible/apis/aptible-api-v1/changes/llm_keys/:id/requests/get.md)

---

[API](https://skmtc.dev/aptible/apis/aptible-api-v1.md) - [All operations](https://skmtc.dev/aptible/apis/aptible-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/aptible/apis/aptible-api-v1/revisions/a21f6b1bc6fe?raw)