---
title: "Retrieve serverless models"
method: GET
path: "/serverless/v1/models"
tags: ["Serverless.Model"]
---

# Retrieve serverless models

`GET /serverless/v1/models`

## Request

- Base URL: `https://api.friendli.ai`
- URL: `https://api.friendli.ai/serverless/v1/models`
- Auth: none declared
- TypeScript: <https://skmtc.dev/friendli/apis/friendli-suite-api-reference/docs/serverless/v1/models/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve list of serverless models.

## Response `200`

Successful Response

- ServerlessModelListSuccess: `/models` API response (for OpenRouters).
  - `data` ModelCatalogResponseItem[], required
    - `id` string, required
    - `name` string, required
    - `max_completion_tokens` integer, required
    - `context_length` integer, required
    - `functionality` Functionality, required: Functionality of the model.
      - `tool_call` boolean, required
      - `builtin_tool` boolean, required
      - `parallel_tool_call` boolean, required
      - `structured_output` boolean
    - `pricing` PricingModel, required: Pricing model supporting both token-based and time-based pricing.
      - `input` number, required: Price per input token
      - `output` number, required: Price per output token
      - `prompt` number, required: Price per input token (alias of input)
      - `completion` number, required: Price per output token (alias of output)
      - `input_cache_read` number, nullable: Price per cached input token read
      - `response_time` number: Price per response time in seconds
      - `audio_minute` number, nullable: Price per audio minute
      - `unit_type` 'TOKEN' | 'SECOND' | 'AUDIO_MINUTE': Serverless price unit type.
    - `hugging_face_url` string, uri, required
    - `description` string, required
    - `license` string, uri, required
    - `policy` string, uri, nullable, required
    - `created` integer, required
    - `deprecation_date` string, nullable: YYYY-MM-DD (UTC date)

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/friendli/apis/friendli-suite-api-reference.md) - [All operations](https://skmtc.dev/friendli/apis/friendli-suite-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/friendli/apis/friendli-suite-api-reference/revisions/38fb43993a11?raw)