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)

Required permissions: serverless:requests:read. Key presets that include them: API, SERVERLESS, READONLY, FULL. See key permissions.

{
  "items": [
    {
      "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "endpoint_id": "fal-ai/flux/dev",
      "started_at": "2025-01-01T00:00:05Z",
      "sent_at": "2025-01-01T00:00:01Z",
      "ended_at": "2025-01-01T00:00:08Z",
      "status_code": 200,
      "duration": 7.8,
      "runner_id": "f1e2d3c4-b5a6-7890-dcba-0987654321fe",
      "billable_units": 1.5
    }
  ]
}