fal.ai icon

fal.ai

Generate AI content using fal.ai models and workflows

Actions10

Model → List Requests

AI-generated

Summary

List requests made to a specified fal.ai model within a selectable time range, allowing filtering by status, request ID, and sorting. Optionally include request input/output payloads in the response.

Inputs

  • Model (required) — The fal.ai endpoint/model to list requests for, selected from a searchable list or specified by ID (e.g., fal-ai/flux/dev).
  • Time Range (required) — The time range for which to list requests, with presets like last 1 hour, 24 hours, 7 days, or a custom range allowing specification of start and end dates in ISO8601 format.
  • Options — Collection of additional filters including Status (All, Success, Error, User Error), Sort By (End Time or Duration), whether to Include Payloads (input and output data), filter by specific Request ID (UUID), and Limit for number of items returned (max 100).

Output shape

a JSON object containing the endpoint ID, time range used for the query, and the list of matching model requests with optional payloads.

The response includes paginated requests matching filters, sorted as specified. Including payloads may increase response size. If using a custom time range, specify both start and end dates. Errors during the request return structured error information.

Links

Discussion