# Retrieve Model

GET

/

router

/

v1

/

models

/

Retrieve Model

```
curl --request GET \
  --url https://api.perplexity.ai/router/v1/models/{model} \
  --header 'Authorization: Bearer <token>'
```

:::code-group
```title="200"
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "owned_by": "<string>",
  "pricing": {
    "input": 123,
    "output": 123,
    "unit": "usd_per_1m_tokens",
    "cache_write": 123,
    "cache_read": 123
  }
}
```

```title="404"
{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "type": "<string>"
  }
}
```
:::

:::callout{intent="info"}
Model ids contain a `/` — pass the full id in the path, for example `GET /router/v1/models/perplexity/kimi-k3`.
:::

#### Authorizations

Authorization

string

header

required

Your Perplexity API key.

#### Path Parameters

model

string

required

The model id, e.g. `perplexity/kimi-k3`.

#### Response

The model.

id

string

required

Public model slug, e.g. `perplexity/kimi-k3`.

object

string

required

Always `model`.

created

integer\<int64>

required

owned\_by

string

required

Provider prefix of the slug, e.g. `perplexity`.

pricing

object

required

Base token prices in USD per 1M tokens. Every field is a price; cache\_read is the effective cached-input price.

:::accordion{title="Show child attributes"}
:::

Was this page helpful?

⌘I

## Related pages

- [Admin & Management](./admin-management-index.md)
- [Agent API](./agent-api-2-index.md)
- [Agent API](./agent-api-index.md)
- [Analytics API](./analytics-api-index.md)
- [Authentication](./authentication-index.md)
- [Changelog](../changelog.md)
- [Cookbook](./cookbook-2-index.md)
- [Embeddings API](./embeddings-api-2-index.md)
- [Embeddings API](./embeddings-api-index.md)
- [Getting Started](./getting-started-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.