> ## Documentation Index > Fetch the complete documentation index at: https://docs.kiteml.com/llms.txt > Use this file to discover all available pages before exploring further. # List Requests > The request log, newest first: each /v1 request of the last 30 days and how it ended. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/requests openapi: 3.1.0 info: title: Kite Platform API description: >- Public API for Kite. Authenticate with `Authorization: Bearer kite_...`, and send `Kite-Version: 2026-09-27` to pin the dated contract your code was written against (without it you get 2026-09-27). Every response carries the version that served it. version: '2026-09-27' servers: - url: https://api.kiteml.com description: Kite Platform API security: - bearerAuth: [] tags: - name: Augmentations description: Generate new episodes from a LeRobot dataset. - name: Training runs description: Fine-tune a policy on a dataset, one run per policy. - name: Twins description: Rebuild a robot episode as an interactable MuJoCo scene (private beta). - name: RL runs description: >- Train a robot policy in simulation from a task spec; get the policy, its scene and a verdict. - name: Evaluations description: >- Preview. Run a policy across simulated scenarios; get its success rate, failure reasons and edge cases. - name: Scenarios description: >- Preview. The scenarios an evaluation runs, and your own, composed from robots, tasks and objects. - name: Objects and environments description: Preview. Bring your own objects and environments to your scenarios. - name: Sim runs description: >- Preview. Run a Kite SDK spec on Kite's machines: episodes, evaluators and a scorecard (enabled per account). - name: Catalog description: Policies, hardware tiers, and dataset inspection. - name: Operations description: Poll any run by its id. - name: Webhooks description: Endpoints that receive events, and the event log. - name: API keys description: The key making the request. - name: Usage description: Token usage and credit balance. - name: Requests description: >- The request log: every call of the last 30 days, who made it and how it ended. - name: Status description: Whether Kite is up, part by part. Needs no key. paths: /v1/requests: get: tags: - Requests summary: List Requests description: >- The request log, newest first: each /v1 request of the last 30 days and how it ended. operationId: list_requests_v1_requests_get parameters: - name: after in: query required: false schema: anyOf: - type: string - type: 'null' description: The previous page's `next_cursor` title: After description: The previous page's `next_cursor` - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: >- `2xx`, `3xx`, `4xx`, `5xx`, `errors` (4xx and 5xx), or one status code such as `429` title: Status description: >- `2xx`, `3xx`, `4xx`, `5xx`, `errors` (4xx and 5xx), or one status code such as `429` - name: api_key_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Only the requests this key made title: Api Key Id description: Only the requests this key made - name: source in: query required: false schema: anyOf: - type: string - type: 'null' description: >- `api`, `cli`, `sdk`, `mcp` or `dashboard`, or several separated by commas (`cli,sdk`) title: Source description: >- `api`, `cli`, `sdk`, `mcp` or `dashboard`, or several separated by commas (`cli,sdk`) - name: path_prefix in: query required: false schema: anyOf: - type: string maxLength: 512 - type: 'null' description: Only paths starting with this, e.g. `/v1/augmentations` title: Path Prefix description: Only paths starting with this, e.g. `/v1/augmentations` - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Limit - $ref: '#/components/parameters/KiteVersion' responses: '200': description: Your requests, newest first content: application/json: schema: $ref: '#/components/schemas/ApiRequestList' '400': description: >- Invalid request (`parameter_invalid`, `unsupported_version`, ...); `param` names the field content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Missing or invalid API key (`unauthenticated`) content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: >- The key lacks a scope this route needs (`missing_scope`), or the feature is not enabled for the account content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '429': description: >- Rate or concurrency limited (`rate_limit_exceeded`, `concurrency_limit_exceeded`, `capacity_exceeded`); honor `Retry-After` content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' components: parameters: KiteVersion: name: Kite-Version in: header required: false description: >- The dated contract your code was written against. Without it you get 2026-09-27; every response says which version served it. schema: type: string enum: - '2026-09-27' default: '2026-09-27' schemas: ApiRequestList: properties: object: type: string enum: - list const: list title: Object default: list data: items: $ref: '#/components/schemas/ApiRequest' type: array title: Data has_more: type: boolean title: Has More next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor type: object required: - data - has_more title: ApiRequestList ApiErrorResponse: properties: error: $ref: '#/components/schemas/ApiErrorBody' type: object required: - error title: ApiErrorResponse description: Every /v1 error has this shape. ApiRequest: properties: id: type: string title: Id description: >- `req_` + a time-ordered ULID: the response's `X-Request-Id`, and the `request_id` of its error object: type: string enum: - request const: request title: Object default: request method: type: string title: Method path: type: string title: Path description: Without the query string, which is never stored route: anyOf: - type: string - type: 'null' title: Route description: >- The route the path matched, e.g. `/v1/augmentations/{augmentation_id}`; null when none did status_code: type: integer title: Status Code duration_seconds: type: number title: Duration Seconds description: Until the response started (a download's transfer is not included) error_code: anyOf: - type: string - type: 'null' title: Error Code description: The error's `code`, for a request that failed api_key: anyOf: - $ref: '#/components/schemas/RequestApiKey' - type: 'null' description: The key that made the request; null for a signed-in session source: type: string title: Source description: >- `cli`, `sdk` or `mcp` (Kite's own clients, by User-Agent), `api` (any other client using a key), or `dashboard` (a signed-in session) user_agent: anyOf: - type: string - type: 'null' title: User Agent description: Up to 256 characters created_at: type: string title: Created At type: object required: - id - method - path - status_code - duration_seconds - source - created_at title: ApiRequest description: One request to /v1. examples: - api_key: id: 5f0c6e2a-8d7b-4c1e-9a3f-2b6d8e4c1a70 key_prefix: kite_abcd1234 name: ci created_at: '2026-09-29T14:02:11.482Z' duration_seconds: 0.184 error_code: insufficient_tokens id: req_01K6BZ4X9RQ2V7M3T8W5Y1N0PC method: POST object: request path: /v1/augmentations route: /v1/augmentations source: cli status_code: 402 user_agent: kite-cli/0.9.0 ApiErrorBody: properties: type: type: string title: Type description: >- invalid_request_error, authentication_error, permission_error, not_found_error, conflict_error, rate_limit_error, or api_error code: type: string title: Code description: 'Machine-readable: branch on this, not on the message' message: type: string title: Message param: anyOf: - type: string - type: 'null' title: Param description: The request field the error is about, when there is one request_id: anyOf: - type: string - type: 'null' title: Request Id description: Also in the X-Request-Id header; quote it to support details: anyOf: - type: object - type: 'null' title: Details description: >- Extra data for some codes (e.g. the cameras a dataset does have, for camera_not_found) type: object required: - type - code - message title: ApiErrorBody RequestApiKey: properties: id: type: string title: Id name: anyOf: - type: string - type: 'null' title: Name key_prefix: anyOf: - type: string - type: 'null' title: Key Prefix description: The key's first characters (`kite_` + 8), to recognise it by type: object required: - id title: RequestApiKey securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Kite API key (`kite_...`), from **Platform API → Keys** in the dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.