ReferenceAPI reference
Catalog
models, endpoints, prices
GET
/v1/modelsAuthorization
bearer AuthorizationBearer <token>
In: header
Query Parameters
vendor?string
modality?unknown
Value in
- "text"
- "image"
- "audio"
- "video"
capability?array<>
repeatable; all must match
zdr?"1"
Value in
- "1"
no_train?"1"
Value in
- "1"
new?"1"
released this week
Value in
- "1"
price_changed?"1"
a price change in the last 7 days
Value in
- "1"
status?unknown
Value in
- "active"
- "deprecated"
q?string
sort?unknown
Default
"name"Value in
- "name"
- "price"
- "latency"
- "popularity"
- "newest"
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/models"{ "object": "list", "data": [ { "id": "openai/gpt-5-mini", "vendor": "openai", "name": "GPT-5 mini", "modalities": { "in": [ "text", "image" ], "out": [ "text" ] }, "context_length": 400000, "max_output": 128000, "pricing_from": { "input": 0.25, "output": 2, "cache_read": 0.025 }, "endpoints": 1, "status": "active", "markup_bps": 0, "capabilities": { "tools": true, "json_schema": true, "vision": true, "audio": false, "reasoning": true, "cache": true, "zdr": true, "no_train": true }, "uptime_30d": 0.9991, "ttft_p50_ms": 180, "requests_7d": 12000 } ]}GET
/v1/models/{vendor}/{model}Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
vendor*string
Match
^[a-z0-9-]+$model*string
Match
^[A-Za-z0-9._-]+$Response Body
application/json
application/json
curl -X GET "https://example.com/v1/models/string/string"{ "id": "openai/gpt-5-mini", "vendor": "openai", "name": "GPT-5 mini", "modalities": { "in": [ "text", "image" ], "out": [ "text" ] }, "context_length": 400000, "max_output": 128000, "pricing_from": { "input": 0.25, "output": 2, "cache_read": 0.025 }, "endpoints": 1, "status": "active", "markup_bps": 0, "capabilities": { "tools": true, "json_schema": true, "vision": true, "audio": false, "reasoning": true, "cache": true, "zdr": true, "no_train": true }, "uptime_30d": 0.9991, "ttft_p50_ms": 180, "requests_7d": 12000}GET
/v1/models/{vendor}/{model}/statsAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
vendor*string
model*string
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/models/string/string/stats"{ "model": "openai/gpt-5-mini", "series": [ { "endpoint_id": "ep_openai_gpt-5-mini_us", "day": "2026-09-09", "attempts": 1600, "ok": 1598, "ttft_p50_ms": 180, "ttft_p95_ms": 420, "tpot_p50_ms": 12 } ], "apps": [ { "app_id": "chatbot", "requests_7d": 4000, "tokens_7d": 1200000 } ], "scheduled_prices": [], "changelog": [ { "id": 2, "kind": "price_change", "summary": "output price cut to $2/M", "endpoint_id": "ep_openai_gpt-5-mini_us", "effective_at": "2026-09-12T10:00:00Z", "created_at": "2026-09-09T00:00:00Z" } ], "analytics": true}GET
/v1/models/{vendor}/{model}/endpointsAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
vendor*string
Match
^[a-z0-9-]+$model*string
Match
^[A-Za-z0-9._-]+$Response Body
application/json
application/json
curl -X GET "https://example.com/v1/models/string/string/endpoints"{ "object": "list", "model": "openai/gpt-5-mini", "data": [ { "id": "ep_openai_gpt-5-mini_us", "provider": "openai", "provider_name": "OpenAI", "upstream_model": "gpt-5-mini", "region": "us", "status": "active", "quantization": "", "context_length": 400000, "max_output": 128000, "capabilities": { "tools": { "function": true, "parallel": true } }, "price": { "input": 0.25, "output": 2, "cache_read": 0.025 }, "markup_bps": 0, "data_policy": { "trains": false, "retention_days": 30, "zdr": true }, "uptime_30d": 0.9991, "latency": { "ttft_p50_ms": 180, "ttft_p95_ms": 420 }, "attempts_30d": 48000 } ]}curl -X GET "https://example.com/v1/pricing"{ "currencies": [ "INR", "USD" ], "rails": [ { "rail": "razorpay", "items": [ { "method": "upi", "bps": 0 }, { "method": "netbanking", "bps": 190 }, { "method": "card_domestic", "bps": 200 }, { "method": "card_international", "bps": 350 } ] }, { "rail": "stripe", "items": [ { "method": "card", "bps": 290, "fixed_minor": 30, "note": "+ 1.5% for international cards" }, { "method": "link", "bps": 290, "fixed_minor": 30 }, { "method": "ach_debit", "bps": 80, "note": "capped at $5" } ] } ], "gst": { "rate_bps": 1800, "supplier_state": "23", "rule": "18% GST on supplies to Indian recipients: CGST 9% + SGST 9% intra-state, IGST 18% otherwise; exports zero-rated under LUT" }, "fx": { "day": "2026-09-10", "usd_inr": "83.91750000", "spread_bps": 50 }, "plans": [ { "id": "payg", "name": "Pay as you go", "monthly_minor": 0, "currency": "", "included_micro": 0, "limits": { "rpm": 600, "tpm": 2000000, "concurrency": 32, "keys": 50, "projects": 10 }, "features": {}, "description": "Prepaid credits, no monthly fee.", "public": true, "sort": 10 }, { "id": "team-small", "name": "Team S", "monthly_minor": 4900, "currency": "USD", "included_micro": 50000000, "limits": { "rpm": 3000, "tpm": 10000000, "concurrency": 128, "keys": 200, "projects": 50 }, "features": { "priority_support": false, "sso": false }, "description": "USD 49 per month, USD 50 of credits included, higher limits.", "public": true, "sort": 20 } ], "minimums_minor": { "INR": 50000, "USD": 500 }, "markup": { "frontier_bps": 0, "open_weight_min_bps": 500, "open_weight_max_bps": 1500, "note": "frontier models pass through at list price; open-weight endpoints carry the markup shown per model" }, "supplier": { "legal_name": "ai.ml", "state": "Madhya Pradesh", "gstin": true }, "generated_at": "2026-09-10T12:00:00Z"}GET
/v1/rankingsQuery Parameters
days?integer
Range
1 <= value <= 90category?string
restrict the app list to a single registry category
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/rankings"{ "days": 7, "apps": [ { "id": "chatbot", "requests": 40000, "tokens": 12000000, "models": 3 } ], "models": [ { "id": "openai/gpt-5-mini", "requests": 30000, "tokens": 9000000, "apps": 2 } ], "analytics": true, "generated_at": "2026-09-10T12:00:00Z"}curl -X GET "https://example.com/v1/providers"{ "object": "list", "data": [ { "id": "openai", "name": "OpenAI", "trains": false, "retention_days": 30, "zdr": true, "regions": [ "us" ], "status": "active", "terms_url": "https://openai.com/policies/api-data-usage-policies", "endpoints": 3, "verified_at": "2026-09-09T00:00:00Z" } ], "snapshot": "2026-09-10T06:00:00Z-a1b2c3"}curl -X GET "https://example.com/v1/apps/string/public"{ "slug": "my-chatbot", "name": "My Chatbot", "category": "chat", "tokens_30d": 12000000, "requests_30d": 40000, "models": [], "trend": [], "analytics": true, "generated_at": "2026-09-10T12:00:00Z"}curl -X GET "https://example.com/v1/apps/string/badge""string"