> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requesty.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# List Decision Models
> Get all available decision models. If authenticated with a Requesty API key, returns only the models approved for your organization. Otherwise, returns all public models. Aliases and routing policies are chat-only and are never returned here.
```bash cURL theme={"dark"}
curl https://router.requesty.ai/v1/models/decision \
-H "Authorization: Bearer YOUR_REQUESTY_API_KEY"
```
```python Python theme={"dark"}
import httpx
response = httpx.get(
"https://router.requesty.ai/v1/models/decision",
headers={"Authorization": "Bearer YOUR_REQUESTY_API_KEY"},
)
for model in response.json()["data"]:
print(model["id"])
```
```typescript TypeScript theme={"dark"}
const response = await fetch("https://router.requesty.ai/v1/models/decision", {
headers: { Authorization: `Bearer ${process.env.REQUESTY_API_KEY}` },
});
const { data } = await response.json();
for (const model of data) {
console.log(model.id);
}
```
```json Response 200 theme={"dark"}
{
"object": "list",
"data": [
{
"api": "decision",
"id": "openai/gpt-6-luna",
"object": "model",
"created": 1791294366,
"updated": 1791294366,
"owned_by": "system",
"pricing": {
"input": 4.2e-08,
"output": 0
},
"data_retention": false,
"data_retention_days": 0,
"data_used_for_training": false,
"privacy_comments": "",
"geolocation": "global"
}
]
}
```
List the decision models available through the [`/v1/decisions`](/api-reference/endpoint/decisions-create) endpoint.
Aliases and routing policies exist for chat only, so they never appear here.
## Authentication
Authentication is optional. The API key can be sent as either `Authorization: Bearer YOUR_REQUESTY_API_KEY` or `X-Api-Key: YOUR_REQUESTY_API_KEY`; both headers behave identically.
| Request | Status | Result |
| - | - | - |
| No `Authorization` or `X-Api-Key` header | `200` | All publicly available models |
| Valid API key | `200` | Only the models approved for your organization and allowed by the key's access list |
| Invalid, expired or revoked API key | `403` | `Invalid authorization token` — the request is rejected, not treated as anonymous |
## OpenAPI
````yaml GET /v1/models/decision
openapi: 3.0.3
info:
title: Requesty Inference API
description: >-
Requesty Inference API for AI model routing. OpenAI-compatible endpoints for
chat completions, embeddings, images, audio, and more.
version: 1.0.0
servers:
- url: https://router.requesty.ai
description: Inference router endpoint
security:
- BearerAuth: []
paths:
/v1/models/decision:
servers:
- url: https://router.requesty.ai
description: Inference router endpoint
get:
summary: List available decision models
description: >-
Get all available decision models. If authenticated with a Requesty API
key, returns only the models approved for your organization. Otherwise,
returns all public models. Aliases and routing policies are chat-only
and are never returned here.
operationId: listDecisionModels
responses:
'200':
description: List of available models
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionModelsResponse'
example:
object: list
data:
- api: decision
id: openai/gpt-6-luna
object: model
created: 1791294366
updated: 1791294366
owned_by: system
pricing:
input: 4.2e-8
output: 0
data_retention: false
data_retention_days: 0
data_used_for_training: false
privacy_comments: ''
geolocation: global
'400':
description: Bad request - malformed payload or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized - missing or empty Authorization header.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'402':
description: Payment required - organization balance exhausted.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: >-
Forbidden - the API key provided in Authorization or X-Api-Key is
invalid, expired or revoked. Omit the header to list public models
anonymously.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found - provider/model not supported.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limit exceeded. Retry after the Retry-After header value.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'502':
description: Bad gateway - upstream provider returned an invalid response.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
- ApiKeyAuth: []
- {}
components:
schemas:
DecisionModelsResponse:
type: object
required:
- object
- data
properties:
object:
type: string
enum:
- list
description: The object type, always 'list'
data:
type: array
items:
$ref: '#/components/schemas/DecisionModel'
description: The list of available decision models
ErrorResponse:
type: object
required:
- error
properties:
error:
type: object
required:
- origin
- message
properties:
origin:
type: string
enum:
- router
- provider
description: >-
Whether the error originated from Requesty's router or an
upstream provider.
message:
type: string
description: Human-readable error description.
DecisionModel:
type: object
properties:
api:
type: string
enum:
- decision
description: The modality of the model, always 'decision'
id:
type: string
description: The model identifier (e.g., 'openai/gpt-6-luna')
object:
type: string
enum:
- model
description: The object type, always 'model'
created:
type: integer
description: The Unix timestamp (in seconds) when the model was created
updated:
type: integer
description: The Unix timestamp (in seconds) when the model was last updated
owned_by:
type: string
description: The system or organization that owns the model
example: system
pricing:
type: object
description: Prices for the model.
properties:
input:
type: number
format: float
description: Price per input token in USD
output:
type: number
format: float
description: Price per output token in USD
data_retention:
type: boolean
description: Whether the provider retains request data
data_retention_days:
type: integer
description: Number of days the provider retains request data
data_used_for_training:
type: boolean
description: Whether the provider may use request data for training
privacy_comments:
type: string
description: Additional privacy notes for the model
geolocation:
type: string
description: Region the model is served from, e.g. 'us' or 'eu'
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: API key for authentication
ApiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
description: API key for authentication (alternative to Bearer auth)
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.