List Models

GET/v1/models

List enabled API models with pagination, filters, and fuzzy search by model name.

Authentication is required. Use an API key in the Authorization: Bearer sk-sb-... header.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number. Values below 1 are treated as 1.
pageSize	integer	20	Number of results per page. Must be between 1 and 100; invalid values default to 20.
q	string	-	Fuzzy search over model name, display name, vendor, and description.
vendor	string	-	Filter by vendor, for example OpenAI or Anthropic.
type	string	-	Filter by type: llm, vision, image, video, audio, or embedding.
order	string	sort_order	Sort order: sort_order, most-popular, newest, or name.

Response

The list response returns lightweight catalog fields only. It does not include a pricing object and does not include detailed token/cache/reasoning price fields. Use base_price and price_formula for list displays; call Get Model for full model_card pricing, schema, and skills.

{
  "data": [
    {
      "id": "model_01abc...",
      "name": "openai/gpt-4o",
      "display_name": "GPT-4o",
      "vendor": "OpenAI",
      "type": "llm",
      "description": "Most capable GPT-4 model with vision...",
      "capability_tags": ["chat", "vision", "tools", "json_mode"],
      "execution_mode": "chat",
      "context_length": 128000,
      "published_at": "2026-07-07T00:00:00Z",
      "vendor_slug": "openai",
      "model_slug": "gpt-4o",
      "enabled": true,
      "featured": true,
      "base_price": "0.000000",
      "price_formula": "$input_tokens * 0.0000025 + $output_tokens * 0.000010"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 20
}

Example

# List LLM models
curl "https://api.sandbase.ai/v1/models?type=llm&page=1&pageSize=20" \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"

# Search by model name or display name
curl "https://api.sandbase.ai/v1/models?q=claude" \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"

# List models by vendor
curl "https://api.sandbase.ai/v1/models?vendor=Anthropic" \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"