> ## Documentation Index > Fetch the complete documentation index at: https://developers.meshapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search Models > 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 here. Which provider serves a model is not something a caller can pin on the inference API, so filtering the catalog by it would offer a choice that doesn't exist. The providers themselves are not secret — ``GET /v1/models/{model_id}/providers`` lists them with their prices — they just aren't a dimension of this listing. ## OpenAPI ````yaml /api/openapi.json get /v1/models/search openapi: 3.1.0 info: title: MeshAPI description: One key, all AI models. version: 0.1.0 servers: - url: https://api.meshapi.ai security: - BearerAuth: [] paths: /v1/models/search: get: tags: - 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 here. Which provider serves a model is not something a caller can pin on the inference API, so filtering the catalog by it would offer a choice that doesn't exist. The providers themselves are not secret — ``GET /v1/models/{model_id}/providers`` lists them with their prices — they just aren't a dimension of this listing. operationId: search_models parameters: - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Fuzzy search over name, id, and brand title: Q description: Fuzzy search over name, id, and brand - name: free in: query required: false schema: anyOf: - type: boolean - type: 'null' description: 'Plan filter: true = free only, false = paid only, omit = all' title: Free description: 'Plan filter: true = free only, false = paid only, omit = all' - name: discounted in: query required: false schema: anyOf: - type: boolean - type: 'null' description: true = discounted only, false = regular only, omit = all title: Discounted description: true = discounted only, false = regular only, omit = all - name: input_modality in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Match models accepting any of these input modalities title: Input Modality description: Match models accepting any of these input modalities - name: output_modality in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- Match any output modality (incl. 'embedding'/'realtime' capabilities) title: Output Modality description: >- Match any output modality (incl. 'embedding'/'realtime' capabilities) - name: brand in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Filter by brand (vendor) title: Brand description: Filter by brand (vendor) - name: sort in: query required: false schema: enum: - brand - name - id - context_length type: string default: brand title: Sort - name: order in: query required: false schema: enum: - asc - desc type: string default: asc title: Order - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset - in: header name: X-Mesh-Version required: false schema: type: string enum: - 2026-08 default: 2026-08 example: 2026-08 description: >- 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. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ModelsPage' examples: default: summary: Example response value: items: - id: openai/gpt-4o-mini name: GPT-4o mini brand: openai provider: openai context_length: 128000 is_free: false pricing: pricing_unit: per_1m_tokens prompt_usd_per_1m: '0.1500000' completion_usd_per_1m: '0.6000000' input_usd_per_unit: '0.1500000' output_usd_per_unit: '0.6000000' request_usd: '0.0000000' description: Fast, affordable multimodal model for everyday tasks. supports_thinking: false supports_completions_api: true supports_responses_api: true 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 model_type: text input_modalities: - text - image output_modalities: - text context_window: 128000 standard_context_threshold: 64000 total: 1 limit: 20 offset: 0 brands: - openai '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: ModelsPage: properties: items: items: $ref: '#/components/schemas/ModelOut' type: array title: Items total: type: integer title: Total limit: type: integer title: Limit offset: type: integer title: Offset brands: items: type: string type: array title: Brands type: object required: - items - total - limit - offset - brands title: ModelsPage description: Paginated envelope returned by ``GET /v1/models/search``. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ModelOut: properties: id: type: string title: Id name: type: string title: Name brand: anyOf: - type: string - type: 'null' title: Brand context_length: anyOf: - type: integer - type: 'null' title: Context Length is_free: type: boolean title: Is Free pricing: $ref: '#/components/schemas/ModelPricing' description: anyOf: - type: string - type: 'null' title: Description supports_thinking: type: boolean title: Supports Thinking supports_completions_api: type: boolean title: Supports Completions Api supports_responses_api: type: boolean title: Supports Responses Api supports_realtime: type: boolean title: Supports Realtime default: false supports_embeddings: type: boolean title: Supports Embeddings default: false supports_tools: type: boolean title: Supports Tools default: false supports_structured_output: type: boolean title: Supports Structured Output default: false supports_system_prompt: type: boolean title: Supports System Prompt default: true supports_batching: type: boolean title: Supports Batching default: false supports_background_response: type: boolean title: Supports Background Response default: false supports_video_generation: type: boolean title: Supports Video Generation default: false supports_image_edit: type: boolean title: Supports Image Edit default: false supports_image_inpaint: type: boolean title: Supports Image Inpaint default: false supports_image_outpaint: type: boolean title: Supports Image Outpaint default: false supports_image_mix: type: boolean title: Supports Image Mix default: false supports_image_reframe: type: boolean title: Supports Image Reframe default: false supports_image_upscale: type: boolean title: Supports Image Upscale default: false supports_image_remove_background: type: boolean title: Supports Image Remove Background default: false supports_image_reference: type: boolean title: Supports Image Reference default: false model_type: type: string title: Model Type input_modalities: items: type: string type: array title: Input Modalities output_modalities: items: type: string type: array title: Output Modalities context_window: anyOf: - type: integer - type: 'null' title: Context Window standard_context_threshold: anyOf: - type: integer - type: 'null' title: Standard Context Threshold realtime_session_max_tokens: anyOf: - type: integer - type: 'null' title: Realtime Session Max Tokens realtime_max_concurrent_per_owner: anyOf: - type: integer - type: 'null' title: Realtime Max Concurrent Per Owner is_composite: type: boolean title: Is Composite default: false composite_models: anyOf: - items: type: string type: array - type: 'null' title: Composite Models type: object required: - id - name - context_length - is_free - pricing - supports_thinking - supports_completions_api - supports_responses_api - model_type - input_modalities - output_modalities title: ModelOut ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ModelPricing: properties: pricing_unit: anyOf: - type: string - type: 'null' title: Pricing Unit prompt_usd_per_1m: anyOf: - type: string - type: 'null' title: Prompt Usd Per 1M completion_usd_per_1m: anyOf: - type: string - type: 'null' title: Completion Usd Per 1M input_usd_per_unit: anyOf: - type: string - type: 'null' title: Input Usd Per Unit output_usd_per_unit: anyOf: - type: string - type: 'null' title: Output Usd Per Unit image_output_usd_per_image: anyOf: - type: string - type: 'null' title: Image Output Usd Per Image request_usd: anyOf: - type: string - type: 'null' title: Request Usd long_context_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Long Context Input Usd Per 1M long_context_output_usd_per_1m: anyOf: - type: string - type: 'null' title: Long Context Output Usd Per 1M cache_read_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Cache Read Input Usd Per 1M cache_write_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Cache Write Input Usd Per 1M cache_read_audio_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Cache Read Audio Input Usd Per 1M long_context_cache_read_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Long Context Cache Read Input Usd Per 1M long_context_cache_write_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Long Context Cache Write Input Usd Per 1M batch_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Batch Input Usd Per 1M batch_output_usd_per_1m: anyOf: - type: string - type: 'null' title: Batch Output Usd Per 1M training_usd_per_1m: anyOf: - type: string - type: 'null' title: Training Usd Per 1M fine_tuned_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Fine Tuned Input Usd Per 1M fine_tuned_output_usd_per_1m: anyOf: - type: string - type: 'null' title: Fine Tuned Output Usd Per 1M audio_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Audio Input Usd Per 1M audio_output_usd_per_1m: anyOf: - type: string - type: 'null' title: Audio Output Usd Per 1M transcription_usd_per_1m: anyOf: - type: string - type: 'null' title: Transcription Usd Per 1M cached_audio_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Cached Audio Input Usd Per 1M cached_text_input_usd_per_1m: anyOf: - type: string - type: 'null' title: Cached Text Input Usd Per 1M cache_hit_usd_per_1m: anyOf: - type: string - type: 'null' title: Cache Hit Usd Per 1M output_with_audio_usd_per_1m: anyOf: - type: string - type: 'null' title: Output With Audio Usd Per 1M output_with_video_usd_per_1m: anyOf: - type: string - type: 'null' title: Output With Video Usd Per 1M image_input_usd_per_image: anyOf: - type: string - type: 'null' title: Image Input Usd Per Image image_output_size: anyOf: - type: string - type: 'null' title: Image Output Size image_output_usd_per_image_512: anyOf: - type: string - type: 'null' title: Image Output Usd Per Image 512 image_output_usd_per_image_1k: anyOf: - type: string - type: 'null' title: Image Output Usd Per Image 1K image_output_usd_per_image_2k: anyOf: - type: string - type: 'null' title: Image Output Usd Per Image 2K image_output_usd_per_image_4k: anyOf: - type: string - type: 'null' title: Image Output Usd Per Image 4K video_output_usd_per_unit_480p: anyOf: - type: string - type: 'null' title: Video Output Usd Per Unit 480P video_output_usd_per_unit_720p: anyOf: - type: string - type: 'null' title: Video Output Usd Per Unit 720P video_output_usd_per_unit_1080p: anyOf: - type: string - type: 'null' title: Video Output Usd Per Unit 1080P video_output_usd_per_unit_4k: anyOf: - type: string - type: 'null' title: Video Output Usd Per Unit 4K video_output_with_video_usd_per_unit_480p: anyOf: - type: string - type: 'null' title: Video Output With Video Usd Per Unit 480P video_output_with_video_usd_per_unit_720p: anyOf: - type: string - type: 'null' title: Video Output With Video Usd Per Unit 720P video_output_with_video_usd_per_unit_1080p: anyOf: - type: string - type: 'null' title: Video Output With Video Usd Per Unit 1080P video_output_with_video_usd_per_unit_4k: anyOf: - type: string - type: 'null' title: Video Output With Video Usd Per Unit 4K reasoning_output_usd_per_1m: anyOf: - type: string - type: 'null' title: Reasoning Output Usd Per 1M price_matrix: anyOf: - additionalProperties: true type: object - type: 'null' title: Price Matrix tool_pricing: anyOf: - additionalProperties: true type: object - type: 'null' title: Tool Pricing effective_date: anyOf: - type: string - type: 'null' title: Effective Date deprecated_date: anyOf: - type: string - type: 'null' title: Deprecated Date discount_pct: anyOf: - type: string - type: 'null' title: Discount Pct type: object title: ModelPricing securitySchemes: BearerAuth: type: http scheme: bearer description: >- Enter your MeshAPI key (`rsk_...`) — sent as `Authorization: Bearer `. ````