---
title: "List Requests"
method: GET
path: "/v0/requests/"
tags: ["Requests"]
---

# List Requests

`GET /v0/requests/`

List your team's individual API and app requests in a time range. Each request reports how many credits it consumed (api_credits, ui_credits), its response time (duration, in seconds), HTTP status code, endpoint type and the number of records returned. Use it to inspect per-request consumption and latency. Defaults to the last 5 days when no dates are given.

## Query parameters

- `start_datetime` string, date-time, nullable — Start datetime in ISO format (e.g., 2023-01-01T00:00:00). Defaults to 5 days ago.
- `end_datetime` string, date-time, nullable — End datetime in ISO format (e.g., 2023-01-01T23:59:59). Defaults to now.
- `page` integer — The page number of the results
- `limit` integer — Return at most this many results
- `is_origin_app` boolean, nullable — Filter by origin app or api
- `origin` 'api' | 'app' | 'web' | 'mcp' | 'admin_mcp'
- `api_key_id` string, uuid, nullable — Filter by API key id

## Response `200`

Successful Response

- ListRequestResponse
  - `data` Request[], required
    - `id` integer, required — ID of the request
    - `name` string, nullable — Name of the request
    - `start_datetime` string, date-time, required — Datetime when the request was made
    - `duration` number, nullable — Duration of the request in seconds. If the request didn't complete or timed out, the value will be None.
    - `user_id` integer, nullable — ID of the user who made the request
    - `user` User
      - `id` integer, nullable — ID of the user
      - `first_name` string, nullable — First name of the user
      - `last_name` string, nullable — Last name of the user
      - `email` string, nullable — Email of the user
    - `url` string, required — URL of the request
    - `method` string, nullable — HTTP method of the request
    - `body` object, nullable — Body of the request. Null when the request had no body or when it was too large to include in a list response (see body_too_large).
    - `body_too_large` boolean — True when the request body exceeded the maximum size list responses include inline, so body is null.
    - `type` 'companies' | 'jobs' | 'technologies', nullable — Type of the request
    - `num_returned_companies` integer, nullable — Number of companies returned
    - `num_returned_jobs` integer, nullable — Number of jobs returned
    - `completed` boolean, nullable — Whether the request has completed
    - `status_code` integer, nullable — Status code of the request
    - `ip_address` string, nullable — IP address of the request
    - `is_origin_app` boolean, nullable — If true, request was made from the origin app. If false, request was made from the API.
    - `origin` 'api' | 'app' | 'web' | 'mcp' | 'admin_mcp'
    - `api_key_id` string, uuid, nullable — ID of the API key used for the request, if any.
    - `api_credits` integer, nullable — Number of API credits consumed
    - `ui_credits` integer, nullable — Number of UI credits consumed
  - `metadata` BaseMetadata, required
    - `total_results` integer, nullable — Total number of results

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Content
- `500` — Internal Server Error

## Changes

- **2026-08-27** `56e5f5617e2a` — 1 info
  - added the optional property `data/items/body_too_large` to the response with the `200` status
- **2026-08-20** `8a210ed0928d` — 1 warning, 1 info
  - added the new `admin_mcp` enum value to the `data/items/origin/anyOf[subschema #1: RequestSource]/` response property for the response status `200`
  - added the enum value `admin_mcp` to the property `anyOf[subschema #1: RequestSource]/` of the `query` request parameter `origin`

[Change history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/requests/get.md)

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/revisions/3a2b17eb0748/schema)