> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.meshapi.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.meshapi.ai/_mcp/server.

# Search Models

GET https://api.meshapi.ai/v1/models/search

Paginated, filterable, fuzzy-searchable model listing — server-side equivalent
of the dashboard's former client-side table handling.

Note: there is intentionally no upstream-provider filter — the routing
provider (e.g. openrouter) is never exposed on the public API.

Reference: https://developers.meshapi.ai/api-reference/mesh-api/models/search-models

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: openapi
  version: 1.0.0
paths:
  /v1/models/search:
    get:
      operationId: search-models
      summary: Search Models
      description: >-
        Paginated, filterable, fuzzy-searchable model listing — server-side
        equivalent

        of the dashboard's former client-side table handling.


        Note: there is intentionally no upstream-provider filter — the routing

        provider (e.g. openrouter) is never exposed on the public API.
      tags:
        - models
      parameters:
        - name: q
          in: query
          description: Fuzzy search over name, id, and brand
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: free
          in: query
          description: 'Plan filter: true = free only, false = paid only, omit = all'
          required: false
          schema:
            type:
              - boolean
              - 'null'
        - name: discounted
          in: query
          description: true = discounted only, false = regular only, omit = all
          required: false
          schema:
            type:
              - boolean
              - 'null'
        - name: input_modality
          in: query
          description: Match models accepting any of these input modalities
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: output_modality
          in: query
          description: >-
            Match any output modality (incl. 'embedding'/'realtime'
            capabilities)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: brand
          in: query
          description: Filter by brand (vendor)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: sort
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/V1ModelsSearchGetParametersSort'
        - name: order
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/V1ModelsSearchGetParametersOrder'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelsPage'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
servers:
  - url: https://api.meshapi.ai
    description: Production Server
components:
  schemas:
    V1ModelsSearchGetParametersSort:
      type: string
      enum:
        - brand
        - name
        - id
        - context_length
      default: brand
      title: V1ModelsSearchGetParametersSort
    V1ModelsSearchGetParametersOrder:
      type: string
      enum:
        - asc
        - desc
      default: asc
      title: V1ModelsSearchGetParametersOrder
    ModelPricing:
      type: object
      properties:
        pricing_unit:
          type:
            - string
            - 'null'
        prompt_usd_per_1k:
          type:
            - string
            - 'null'
        completion_usd_per_1k:
          type:
            - string
            - 'null'
        prompt_usd_per_1m:
          type:
            - string
            - 'null'
        completion_usd_per_1m:
          type:
            - string
            - 'null'
        image_output_usd_per_image:
          type:
            - string
            - 'null'
        request_usd:
          type:
            - string
            - 'null'
        long_context_input_usd_per_1m:
          type:
            - string
            - 'null'
        long_context_output_usd_per_1m:
          type:
            - string
            - 'null'
        cache_read_input_usd_per_1m:
          type:
            - string
            - 'null'
        cache_write_input_usd_per_1m:
          type:
            - string
            - 'null'
        cache_read_audio_input_usd_per_1m:
          type:
            - string
            - 'null'
        long_context_cache_read_input_usd_per_1m:
          type:
            - string
            - 'null'
        long_context_cache_write_input_usd_per_1m:
          type:
            - string
            - 'null'
        batch_input_usd_per_1m:
          type:
            - string
            - 'null'
        batch_output_usd_per_1m:
          type:
            - string
            - 'null'
        training_usd_per_1m:
          type:
            - string
            - 'null'
        fine_tuned_input_usd_per_1m:
          type:
            - string
            - 'null'
        fine_tuned_output_usd_per_1m:
          type:
            - string
            - 'null'
        audio_input_usd_per_1m:
          type:
            - string
            - 'null'
        audio_output_usd_per_1m:
          type:
            - string
            - 'null'
        transcription_usd_per_1m:
          type:
            - string
            - 'null'
        cached_audio_input_usd_per_1m:
          type:
            - string
            - 'null'
        cached_text_input_usd_per_1m:
          type:
            - string
            - 'null'
        cache_hit_usd_per_1m:
          type:
            - string
            - 'null'
        output_with_audio_usd_per_1m:
          type:
            - string
            - 'null'
        output_with_video_usd_per_1m:
          type:
            - string
            - 'null'
        image_input_usd_per_image:
          type:
            - string
            - 'null'
        image_output_size:
          type:
            - string
            - 'null'
        effective_date:
          type:
            - string
            - 'null'
        deprecated_date:
          type:
            - string
            - 'null'
        notes:
          type:
            - string
            - 'null'
        source_url:
          type:
            - string
            - 'null'
        discount_pct:
          type:
            - string
            - 'null'
      required:
        - prompt_usd_per_1k
        - completion_usd_per_1k
      title: ModelPricing
    ModelOut:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        brand:
          type:
            - string
            - 'null'
        provider:
          type:
            - string
            - 'null'
        context_length:
          type:
            - integer
            - 'null'
        is_free:
          type: boolean
        pricing:
          $ref: '#/components/schemas/ModelPricing'
        description:
          type:
            - string
            - 'null'
        supports_thinking:
          type: boolean
        supports_completions_api:
          type: boolean
        supports_responses_api:
          type: boolean
        supports_realtime:
          type: boolean
          default: false
        supports_embeddings:
          type: boolean
          default: false
        supports_tools:
          type: boolean
          default: false
        supports_structured_output:
          type: boolean
          default: false
        supports_system_prompt:
          type: boolean
          default: true
        supports_batching:
          type: boolean
          default: false
        supports_background_response:
          type: boolean
          default: false
        supports_video_generation:
          type: boolean
          default: false
        supports_image_edit:
          type: boolean
          default: false
        supports_image_inpaint:
          type: boolean
          default: false
        supports_image_outpaint:
          type: boolean
          default: false
        supports_image_mix:
          type: boolean
          default: false
        supports_image_reframe:
          type: boolean
          default: false
        supports_image_upscale:
          type: boolean
          default: false
        supports_image_remove_background:
          type: boolean
          default: false
        supports_image_reference:
          type: boolean
          default: false
        model_type:
          type: string
        input_modalities:
          type: array
          items:
            type: string
        output_modalities:
          type: array
          items:
            type: string
        context_window:
          type:
            - integer
            - 'null'
        standard_context_threshold:
          type:
            - integer
            - 'null'
        realtime_session_max_tokens:
          type:
            - integer
            - 'null'
        realtime_max_concurrent_per_owner:
          type:
            - integer
            - 'null'
        is_composite:
          type: boolean
          default: false
        composite_models:
          type:
            - array
            - 'null'
          items:
            type: string
      required:
        - id
        - name
        - context_length
        - is_free
        - pricing
        - supports_thinking
        - supports_completions_api
        - supports_responses_api
        - model_type
        - input_modalities
        - output_modalities
      title: ModelOut
    ModelsPage:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ModelOut'
        total:
          type: integer
        limit:
          type: integer
        offset:
          type: integer
        brands:
          type: array
          items:
            type: string
      required:
        - items
        - total
        - limit
        - offset
        - brands
      description: Paginated envelope returned by ``GET /v1/models/search``.
      title: ModelsPage
    ValidationErrorLocItems:
      oneOf:
        - type: string
        - type: integer
      title: ValidationErrorLocItems
    ValidationErrorCtx:
      type: object
      properties: {}
      title: ValidationErrorCtx
    ValidationError:
      type: object
      properties:
        loc:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorLocItems'
        msg:
          type: string
        type:
          type: string
        input:
          description: Any type
        ctx:
          $ref: '#/components/schemas/ValidationErrorCtx'
      required:
        - loc
        - msg
        - type
      title: ValidationError
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

```

## Examples



**Response**

```json
{
  "items": [
    {
      "id": "openai/gpt-4o-mini",
      "name": "GPT-4o mini",
      "context_length": 128000,
      "is_free": false,
      "pricing": {
        "prompt_usd_per_1k": "0.0001500",
        "completion_usd_per_1k": "0.0006000",
        "pricing_unit": "per_1m_tokens",
        "prompt_usd_per_1m": "0.1500000",
        "completion_usd_per_1m": "0.6000000",
        "request_usd": "0.0000000"
      },
      "supports_thinking": false,
      "supports_completions_api": true,
      "supports_responses_api": true,
      "model_type": "text",
      "input_modalities": [
        "text",
        "image"
      ],
      "output_modalities": [
        "text"
      ],
      "brand": "openai",
      "provider": "openai",
      "description": "Fast, affordable multimodal model for everyday tasks.",
      "supports_realtime": false,
      "supports_embeddings": false,
      "supports_tools": true,
      "supports_structured_output": true,
      "supports_system_prompt": true,
      "supports_batching": true,
      "supports_background_response": false,
      "supports_video_generation": false,
      "supports_image_edit": false,
      "supports_image_inpaint": false,
      "supports_image_outpaint": false,
      "supports_image_mix": false,
      "supports_image_reframe": false,
      "supports_image_upscale": false,
      "supports_image_remove_background": false,
      "supports_image_reference": true,
      "context_window": 128000,
      "standard_context_threshold": 64000
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0,
  "brands": [
    "openai"
  ]
}
```

**SDK Code**

```python Example response
import requests

url = "https://api.meshapi.ai/v1/models/search"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Example response
const url = 'https://api.meshapi.ai/v1/models/search';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Example response
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.meshapi.ai/v1/models/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Example response
require 'uri'
require 'net/http'

url = URI("https://api.meshapi.ai/v1/models/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Example response
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.meshapi.ai/v1/models/search")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Example response
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.meshapi.ai/v1/models/search', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Example response
using RestSharp;

var client = new RestClient("https://api.meshapi.ai/v1/models/search");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Example response
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.meshapi.ai/v1/models/search")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```