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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.