Skip to main content
GET
List models
For workflow examples, see the Catalog API guide.

Authorizations

Authorization
string
header
required

Optional SLNG API key, sent as Authorization: Bearer $SLNG_API_KEY. Returns your organization's models and pricing. An invalid key returns 401; it never falls back to the public catalog.

Query Parameters

surface
enum<string>

Set to agent to list only the models enabled for agents and to add agent_availability to each model. Omit for the general catalog.

Available options:
agent
agent_region
string

Agent region code, for example eu-west or us-east-slng. Requires surface=agent. This is the agent's region, not a gateway code or a model hosting region. An unknown code returns an empty list. See Agent regions.

Maximum string length: 50
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"eu-west"

language
string[]

Language code, for example en. Repeat the parameter for several languages, up to 16. With surface=agent, matches the languages an agent can use the model in.

Maximum array length: 16
Maximum string length: 35
Pattern: ^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$
Example:
service_type
enum<string>

Return models of one service type. The general catalog lists speech models (stt and tts); LLMs for agents appear with surface=agent.

Available options:
stt,
llm,
tts
provider
string[]

Provider code, for example deepgram. Repeat for several.

region
string[]

Hosting location of the model's deployments, as listed in available_regions. Repeat for several. Not an agent region code.

use_case
string[]

Use case tag. Repeat for several.

capability
string[]

Capability tag. Repeat for several.

protocol
enum<string>

Return models that support this protocol.

Available options:
https,
wss
slng_hosted_only
boolean
default:false

Return only SLNG-hosted models. Accepts true, false, 1, or 0.

Search text matched against model names and descriptions.

Maximum string length: 200
page
integer
default:1

Page number, starting at 1.

Required range: 1 <= x <= 10000
page_size
integer
default:20

Results per page. In the general catalog a page holds this many model families, and each family brings its matching variants, so items can be longer than page_size. With surface=agent each model counts once.

Required range: 1 <= x <= 100

Response

Matching models and pagination metadata.

items
object[]
required
meta
object
required