> ## Documentation Index
> Fetch the complete documentation index at: https://docs.matterai.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Model

> Get details for a specific model from the MatterAI API

## Authentication

All API requests require authentication using a Bearer token. You can obtain your API key from the [MatterAI Console](https://app.matterai.so).

```bash theme={null}
Authorization: Bearer MATTERAI_API_KEY
```

<Warning>
  Keep your API key secure and never expose it in client-side code. Get your API
  key from the MatterAI console.
</Warning>

## Request

### Path Parameters

<ResponseField name="model_id" type="string" required>
  The ID of the model to retrieve.
</ResponseField>

## Response

<ResponseField name="id" type="string">
  The model identifier.
</ResponseField>

<ResponseField name="name" type="string">
  The model name.
</ResponseField>

<ResponseField name="description" type="string">
  A description of the model.
</ResponseField>

<ResponseField name="object" type="string">
  The object type, which is always `"model"`.
</ResponseField>

<ResponseField name="input_modalities" type="array">
  The input modalities supported by the model.
</ResponseField>

<ResponseField name="context_length" type="integer">
  The maximum context length for the model.
</ResponseField>

<ResponseField name="max_output_length" type="integer">
  The maximum output length for the model.
</ResponseField>

<ResponseField name="output_modalities" type="array">
  The output modalities supported by the model.
</ResponseField>

<ResponseField name="supported_sampling_parameters" type="array">
  The sampling parameters supported by the model.
</ResponseField>

<ResponseField name="supported_features" type="array">
  The features supported by the model.
</ResponseField>

<ResponseField name="openrouter" type="object">
  OpenRouter integration details.

  <Expandable title="OpenRouter Object">
    <ResponseField name="slug" type="string">
      The OpenRouter slug for the model.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="datacenters" type="array">
  The datacenters where the model is available.

  <Expandable title="Datacenter Object">
    <ResponseField name="country_code" type="string">
      The country code of the datacenter.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created" type="integer">
  The Unix timestamp (in seconds) of when the model was created.
</ResponseField>

<ResponseField name="owned_by" type="string">
  The organization that owns the model.
</ResponseField>

<ResponseField name="pricing" type="object">
  Pricing information for the model.

  <Expandable title="Pricing Object">
    <ResponseField name="prompt" type="string">
      The price per prompt token.
    </ResponseField>

    <ResponseField name="completion" type="string">
      The price per completion token.
    </ResponseField>

    <ResponseField name="image" type="string">
      The price per image.
    </ResponseField>

    <ResponseField name="request" type="string">
      The price per request.
    </ResponseField>

    <ResponseField name="input_cache_reads" type="string">
      The price for input cache reads.
    </ResponseField>

    <ResponseField name="input_cache_writes" type="string">
      The price for input cache writes.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://api.matterai.so/v1/models/axon-code' \
  --header 'Authorization: Bearer MATTERAI_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.matterai.so/v1/models/axon-code', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer MATTERAI_API_KEY'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.matterai.so/v1/models/axon-code"
  headers = {
      "Authorization": "Bearer MATTERAI_API_KEY"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "id": "axon-code",
  "name": "Axon Code",
  "description": "Axon Code is super intelligent LLM model for coding tasks",
  "object": "model",
  "input_modalities": [
    "text"
  ],
  "context_length": 256000,
  "max_output_length": 32768,
  "output_modalities": [
    "text"
  ],
  "supported_sampling_parameters": [
    "temperature",
    "top_p",
    "top_k",
    "repetition_penalty",
    "frequency_penalty",
    "presence_penalty",
    "seed",
    "stop"
  ],
  "supported_features": [
    "tools",
    "structured_outputs",
    "web_search"
  ],
  "openrouter": {
    "slug": "matterai/axon"
  },
  "datacenters": [
    {
      "country_code": "US"
    }
  ],
  "created": 1750426201,
  "owned_by": "matterai",
  "pricing": {
    "prompt": "0.000001",
    "completion": "0.000004",
    "image": "0",
    "request": "0",
    "input_cache_reads": "0",
    "input_cache_writes": "0"
  }
}
```

## Error Responses

The API returns standard HTTP status codes to indicate success or failure:

<ResponseField name="401" type="Unauthorized">
  Invalid or missing API key.
</ResponseField>

<ResponseField name="404" type="Not Found">
  The requested model was not found.
</ResponseField>

<ResponseField name="429" type="Rate Limited">
  Too many requests. Please slow down.
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Server error. Please try again later.
</ResponseField>

Example error response:

```json theme={null}
{
  "error": {
    "message": "Model not found",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}
```