Get all available reasoning effort levels for AI responses.

Returns a list of supported reasoning levels with descriptions and default flag.

## Reasoning Levels

- **off** - No extended reasoning; standard model response
- **low** - Minimal reasoning effort; quick analysis
- **medium** - Balanced reasoning effort; thorough analysis (default)
- **high** - Increased reasoning effort; deep analysis
- **maximum** - Maximum reasoning effort; comprehensive analysis


## Returns

Returns an array of reasoning level objects, each with a `level` identifier, a `description`, and an `is_default` flag. The list is returned under the `reasoning_levels` field.


```bash cURL
curl https://api.aitronos.com/v1/model/response/reasoning-levels \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

levels = client.responses.get_reasoning_levels()
for level in levels.reasoning_levels:
    print(f"{level.level}: {level.description}")
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
response = requests.get(
    "https://api.aitronos.com/v1/model/response/reasoning-levels",
    headers={"X-API-Key": api_key}
)
levels = response.json()
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const response = await fetch(
  'https://api.aitronos.com/v1/model/response/reasoning-levels',
  {
    headers: {
      'X-API-Key': apiKey
    }
  }
);
const levels = await response.json();
```

## Response


```json
{
  "success": true,
  "reasoning_levels": [
    {
      "level": "off",
      "description": "No extended reasoning - standard model response",
      "is_default": false
    },
    {
      "level": "low",
      "description": "Minimal reasoning effort - quick analysis",
      "is_default": false
    },
    {
      "level": "medium",
      "description": "Balanced reasoning effort - thorough analysis (default)",
      "is_default": true
    },
    {
      "level": "high",
      "description": "Increased reasoning effort - deep analysis",
      "is_default": false
    },
    {
      "level": "maximum",
      "description": "Maximum reasoning effort - comprehensive analysis",
      "is_default": false
    }
  ]
}
```

## Related Resources

- [Create Response](/docs/api-reference/responses/create)
- [Cancel Response](/docs/api-reference/responses/cancel)
- [Threads Overview](/docs/documentation/core-concepts/threads-overview)