Sign in
Models
Requests

List requests by endpoint(s)

Lists requests for one or more endpoints (same endpoint_id style as usage/explore: comma-separated or repeated query params, up to 50 IDs).

Authentication: Requires API key (user or enterprise).

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
get/models/requests/by-endpoint

Query parameters

limitinteger

Number of items to return per page (max 100)

Example:20

Number of items to return per page (max 100)

cursorstring

Pagination cursor encoding the page number

Example:Mg==

Pagination cursor encoding the page number

string required
OR
string[] 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 date-time
OR
string

Start date in ISO8601 format (e.g., '2025-01-01T00:00:00Z' or '2025-01-01'). Defaults to 24 hours ago.

string date-time
OR
string

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.

status'success' | 'error' | 'user_error'

Filter by request status

Example:success

Filter by request status

request_idstring uuid

Filter by specific request ID

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Filter by specific request ID

string
OR
string[]

Fields to expand in the response. Use payloads to include input and output payloads.

sort_by'ended_at' | 'duration'

Sort results by end time or duration

Example:ended_at

Sort results by end time or duration

Response

Requests listed successfully

next_cursorstring nullable required

Cursor for the next page of results, null if no more pages

has_moreboolean required

Boolean indicating if more results are available (convenience field derived from next_cursor)

Example response

{
  "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
    }
  ]
}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.