---
title: "List Api Requests"
method: GET
path: "/v1/account/api-requests"
tags: ["v1"]
---

# List Api Requests

`GET /v1/account/api-requests`

## Request

- Base URL: `https://api.ellipsis.dev`
- URL: `https://api.ellipsis.dev/v1/account/api-requests`
- Auth: HTTP bearer

List requests made to the API with API keys, user tokens, and session tokens, newest first.

## Query parameters

- `start` string, date-time, nullable: Only requests at or after this time.
- `end` string, date-time, nullable: Only requests before this time.
- `operation` string[], nullable: Only requests to these operations.
- `status_code` integer[], nullable: Only requests that returned these status codes.
- `credential_type` ApiRequestCredentialType[], nullable: Only requests made with these credential types.
- `credential_id` string[], nullable: Only requests made with these API keys, user tokens, or sessions, by id.
- `limit` integer
- `cursor` string, nullable: The `next_cursor` of the previous page.

## Headers

- `user-agent` string, nullable

## Response `200`

Successful Response

- ApiRequestsListResponse
  - `api_requests` ApiRequest[], required
    - `created_at` string, date-time, required
    - `credential` ApiRequestCredential, required: The credential that authenticated a request.
      - `id` string, nullable, required: The API key or user token id. For a session token, the session id.
      - `name` string, nullable, required: The API key or user token name. Null for a session token.
      - `type` 'api_key' | 'user_token' | 'session_token', required
    - `duration_ms` integer, required
    - `id` string, required: The `X-Request-ID` header returned with the response.
    - `method` string, required
    - `operation` string, nullable, required: The operation id, such as `start_session`. Null when the path matched no route.
    - `path` string, required
    - `status_code` integer, required
    - `user_agent` string, nullable, required
  - `has_more` boolean: Whether more results exist past this page.
  - `next_cursor` string, nullable: Pass as `cursor` to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.

## Other responses

- `400`: The request is invalid or combines incompatible fields.
- `401`: The bearer token is missing, invalid, or revoked.
- `403`: The credential may not perform this action, or the account is blocked.
- `422`: Validation Error

---

[API](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api.md) - [All operations](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/revisions/344b16df9a1a?raw)