Search Models
Paginated, filterable, fuzzy-searchable model listing.
Every multi-value filter is an OR within its dimension and an AND across dimensions.
facets counts each dimension with its own filter dropped, so adding a second value to
a dimension always widens the result set.
There is intentionally no upstream-provider filter here. Which provider serves a model
is not something a caller can pin on the inference API, so filtering the catalogue by it
would offer a choice that doesn’t exist. The providers are not secret —
GET /v1/models/{model_id}/providers lists them with their prices — they just aren’t a
dimension of this listing.
Authorizations
Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.
Headers
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.
2026-08, 2026-09 Query Parameters
Fuzzy search over name, id, and brand
Plan filter: true = free only, false = paid only, omit = all
true = discounted only, false = regular only, omit = all
true = deprecated only, false = not deprecated only, omit = all
Match models accepting any of these input modalities
Match any output modality (incl. 'embedding'/'realtime' capabilities)
Filter by brand (vendor)
Match models whose DEFAULT price row has any of these capabilities (e.g. 'tools', 'thinking', 'image_edit'). The full vocabulary is published in the response's facets.capability.
brand, name, id, context_length, price asc, desc 1 <= x <= 100x >= 0