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

# Fetch pricing

> Fetch the global LLM price book used by Pylva SDK cost calculation.

The SDK uses this Agent SDK endpoint to fetch the currently effective global LLM price book. Direct use is possible, but most teams should let the SDK cache it automatically.

## Authentication

Use an Agent SDK key in `X-Pylva-Key`.

```bash theme={null}
curl https://api.pylva.com/api/v1/pricing \
  -H "X-Pylva-Key: $PYLVA_API_KEY"
```

## Response

```json theme={null}
{
  "models": [
    {
      "id": 1,
      "provider": "openai",
      "model": "gpt-4o-mini",
      "input_per_1m": 0.15,
      "output_per_1m": 0.6,
      "effective_from": "2026-06-11T00:00:00.000Z",
      "effective_to": null,
      "source": "auto",
      "created_at": "2026-06-11T00:00:00.000Z"
    }
  ],
  "updated_at": "2026-06-11T10:00:00.000Z"
}
```

## Notes

* The endpoint returns the full global price book.
* Supplied query parameters are ignored.
* Responses are cacheable for 24 hours.
* Use the Admin API custom-pricing endpoints for builder-specific pricing.
