Skip to main content
GET
Search Models

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08

Query Parameters

q
string | null

Fuzzy search over name, id, and brand

free
boolean | null

Plan filter: true = free only, false = paid only, omit = all

discounted
boolean | null

true = discounted only, false = regular only, omit = all

input_modality
string[] | null

Match models accepting any of these input modalities

output_modality
string[] | null

Match any output modality (incl. 'embedding'/'realtime' capabilities)

brand
string[] | null

Filter by brand (vendor)

sort
enum<string>
default:brand
Available options:
brand,
name,
id,
context_length
order
enum<string>
default:asc
Available options:
asc,
desc
limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

Paginated envelope returned by GET /v1/models/search.

items
ModelOut · object[]
required
total
integer
required
limit
integer
required
offset
integer
required
brands
string[]
required