Skip to main content
GET
/
models
Model search
curl --request GET \
  --url https://api.fal.ai/v1/models \
  --header 'Authorization: <api-key>'
{
  "models": [
    {
      "endpoint_id": "fal-ai/flux/dev",
      "metadata": {
        "display_name": "FLUX.1 [dev]",
        "category": "text-to-image",
        "description": "Fast text-to-image generation",
        "status": "active",
        "tags": [
          "fast",
          "pro"
        ],
        "updated_at": "2025-01-15T12:00:00Z",
        "is_favorited": false,
        "thumbnail_url": "https://fal.media/files/example.jpg",
        "model_url": "https://fal.run/fal-ai/flux/dev",
        "date": "2024-08-01T00:00:00Z",
        "highlighted": true,
        "pinned": false
      }
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Admin API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_ADMIN_API_KEY

Query Parameters

​
limit
integer

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

Required range: x >= 1
Example:

50

​
cursor
string

Pagination cursor from previous response. Encodes the page number.

Example:

"Mg=="

​
endpoint_id

Endpoint ID(s) to retrieve (e.g., 'fal-ai/flux/dev'). Can be a single value or multiple values (1-50 models). When combined with search params, narrows results to these IDs. Use array syntax: ?endpoint_id=model1&endpoint_id=model2

Example:
["fal-ai/flux/dev", "fal-ai/flux-pro"]
​
q
string

Free-text search query to filter models by name, description, or category

Example:

"text to image"

​
category
string

Filter by category (e.g., 'text-to-image', 'image-to-video', 'training')

Example:

"text-to-image"

​
status
enum<string>

Filter models by status - omit to include all statuses

Available options:
active,
deprecated
Example:

"active"

​
expand

Fields to expand in the response. Supported values: 'openapi-3.0' (includes full OpenAPI 3.0 schema in 'openapi' field)

Example:
["openapi-3.0"]

Response

Successfully retrieved model endpoints

Response containing model data with pagination support

​
models
object[]
required

Array of model information

​
has_more
boolean
required

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

​
next_cursor
string | null

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