---
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'
- `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
    - `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'
    - `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 Entity
- `500` — Internal Server Error

---

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