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

# List providers and inspect model prices

> Use GET /v1/reference/providers and GET /v1/prices/search to browse hosts and read token rates for a provider.

Start with the provider catalog when you need to know which hosts Narev tracks. Then pull rates for models on one provider.

## List providers

```bash theme={null}
curl 'https://api.narev.ai/v1/reference/providers'
```

Each item includes `provider_id` and `provider_name`. Use `provider_id` when you filter price rows or call cost endpoints.

## Pull rates for one provider

Search by model, then filter `data` rows by `provider_id`:

```bash theme={null}
curl -G 'https://api.narev.ai/v1/prices/search' \
  --data-urlencode 'q=gpt-4o'
```

Keep rows where `provider_id` equals your target host (for example `openai`). Read `pricing.prompt` and `pricing.completion` from the match.

## Example

OpenAI lists `gpt-4o` with prompt and completion rates in USD per token. Compare those values to another `provider_id` on the same `model_id` when you shop for a cheaper host.

## Related guides

* [Search live model prices](/docs/guides/search-model-prices)
* [Find the cheapest provider for a model](/docs/guides/find-cheapest-host)