---
title: "List requests by endpoint(s)"
method: GET
path: "/serverless/requests/by-endpoint"
tags: ["Serverless", "Requests"]
---

# List requests by endpoint(s)

`GET /serverless/requests/by-endpoint`

Lists requests for one or more endpoints owned by the authenticated user.
Use repeated or comma-separated `endpoint_id` (same as other platform list APIs).

A bare app id ('<owner>/<name>') automatically includes the app's registered
route-level endpoints (e.g. '<owner>/<name>/turbo'); each returned row keeps
the route-level `endpoint_id` it was recorded under. Pass a route-level id
to filter to that route exactly.

**Authentication:** Requires API key.

**Filters:**
- Time range via start / end. If `start` is omitted, defaults to the last 24 hours — unless `request_id` is provided, in which case the default start bound is widened to 90 days.
- Status (success, error, user_error)
- Request ID
- Pagination via cursor/limit (limit defaults to 50, max 100)

**Sorting:**
- By end time (default) or duration

**Expansions:**
- Include payloads by adding expand=payloads
- Include per-request `billable_units` by adding expand=billing (endpoint owner only)

## Query parameters

- `limit` integer — Number of items to return per page (max 100)
- `cursor` string — Pagination cursor encoding the page number
- `endpoint_id` union, required — Filter by specific endpoint ID(s). Accepts 1-50 endpoint IDs. Supports comma-separated values: ?endpoint_id=model1,model2 or array syntax: ?endpoint_id=model1&endpoint_id=model2
  - string
  - string[]
- `start` union — Start date in ISO8601 format (e.g., '2025-01-01T00:00:00Z' or '2025-01-01'). Defaults to 24 hours ago.
  - string, date-time
  - string
- `end` union — End date in ISO8601 format, exclusive (e.g., '2025-02-01T00:00:00Z' or '2025-02-01'). Data up to but not including this timestamp is returned. Defaults to current time.
  - string, date-time
  - string
- `status` 'success' | 'error' | 'user_error' — Filter by request status
- `request_id` string, uuid — Filter by specific request ID
- `expand` union — Fields to expand in the response. Use payloads to include input and output payloads. Use billing to include billable_units per request.
  - string
  - string[]
- `sort_by` 'ended_at' | 'duration' — Sort results by end time or duration

## Response `200`

Requests listed successfully

- object — Paginated list of serverless requests for the specified endpoint
  - `next_cursor` string, nullable, required — Cursor for the next page of results, null if no more pages
  - `has_more` boolean, required — Boolean indicating if more results are available (convenience field derived from next_cursor)
  - `items` object[], required — List of requests matching the filter
    - `request_id` string, uuid, required — Unique identifier for the request
    - `endpoint_id` string, required — Endpoint that was executed for this request
    - `started_at` string, date-time, required — Time when request processing started
    - `sent_at` string, date-time, required — Time when request was sent to the backend
    - `ended_at` string, date-time, nullable — Time when request finished processing
    - `status_code` integer, nullable — HTTP status code returned by the request
    - `duration` number, nullable — Total request duration in seconds
    - `json_input` unknown
    - `json_output` unknown
    - `runner_id` string, uuid, nullable, required — Unique identifier for the runner execution instance. Null if no runner was assigned (e.g. the request failed before dispatch).
    - `billable_units` number, nullable — Billable units for this request (only present when expand=billing). Null if a billing event has not yet been recorded for this request.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Access denied
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)