Skip to main content
GET
/
assets
/
models
List Models
curl --request GET \
  --url https://api.example.com/assets/models \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "resource_uri": "<string>",
      "name": "<string>",
      "litellm_model": "<string>",
      "project_id": "<string>",
      "created_by": "<string>",
      "owner_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "provider": "<string>",
      "description": "<string>",
      "tags": []
    }
  ],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total_items": 1,
    "total_pages": 1,
    "next_page": 123,
    "prev_page": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Project-ID
string | null

Query Parameters

​
page
integer
default:1

Page number (starts at 1)

Required range: x >= 1
​
limit
integer
default:20

Items per page

Required range: 1 <= x <= 100
​
search
string | null

Search in name and description

​
status
enum<string> | null

Filter by status Status of a model configuration.

Available options:
PENDING,
ACTIVE,
ERROR,
DEPRECATED,
DISABLED
​
mode
enum<string> | null

Filter by model mode Supported model modes.

Available options:
chat,
completion,
embedding,
image_generation,
audio_transcription
​
tags
string | null

Filter by tags (comma-separated)

​
sort
string | null

Sort: field:order,... (e.g., name:asc,created_at:desc)

​
created_by
string | null

Filter by creator (e.g., 'user:alice')

​
owner_id
string | null
deprecated

Deprecated: use created_by instead. Will be removed in a future release.

Response

Successful Response

Paginated list response for models.

​
data
ModelSummary · object[]
required
​
pagination
Pagination · object
required

Pagination metadata for list responses.