---
title: "List Api Requests"
method: GET
path: "/api_requests"
tags: ["API Requests"]
---

# List Api Requests

`GET /api_requests`

List all API requests

## Query parameters

- `api_key_id` string[] — If provided, only return requests made with the given [API key](https://docs.buttondown.com/api-authentication) ID(s).
- `creation_date__gt` string, date-time — If provided, only return requests created after the given datetime.
- `creation_date__lt` string, date-time — If provided, only return requests created before the given datetime.
- `date__end` string, date — If provided, only return requests created on or before the given date.
- `date__start` string, date — If provided, only return requests created on or after the given date.
- `limit` integer — The maximum number of results to return per page.
- `method` string[] — If provided, only return requests with the given HTTP method(s).
- `path` string[] — If provided, only return requests matching the given API path(s).
- `source` APIRequestSource[] — If provided, only return requests from the given source(s).
- `status_code` string[] — If provided, only return requests with the given HTTP status code(s).
- `version` string[] — If provided, only return requests made with the given [API version](https://docs.buttondown.com/api-versioning)(s).

## Response `200`

OK

- APIRequestList
  - `results` APIRequest[], required — The list of API requests on this page.
    - `id` string, required — A unique TypeID associated with the object.
    - `creation_date` string, date-time, required — The date and time at which the object was first created.
    - `status_code` integer, required — The HTTP status code the API returned.
    - `path` string, required — The request path (e.g. `/v1/subscribers`).
    - `method` string, required — The HTTP method used (e.g. `GET`, `POST`).
    - `source` 'api' | 'app' | 'axios' | 'carrd' | 'cli' | 'curl' | 'go' | 'make' | 'netlify' | 'node' | 'pipedream' | 'powershell' | 'python' | 'ruby' | 'wordpress' | 'zapier', required — An enumeration.
    - `version` '2024-07-01' | '2024-08-01' | '2024-08-15' | '2024-09-30' | '2024-12-30' | '2025-01-02' | '2025-05-19' | '2025-06-01' | '2026-01-01' | '2026-04-01', required — The API version the request was made against.
    - `ip_address` string, required — The IP address the request was made from.
    - `api_key_id` string, nullable — The ID of the API key used, if authenticated via API key.
    - `api_key_label` string, nullable — The human-readable label of the API key used, if any.
  - `cursor` string, nullable — An opaque cursor to pass back to fetch the next page, or null if this is the last page.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `429` — Too Many Requests

---

[API](https://skmtc.net/buttondown/apis/buttondown-api.md) · [All operations](https://skmtc.net/buttondown/apis/buttondown-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/buttondown/buttondown-api/versions/3a702c095d22/schema)