> ## 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.

# List custom pricing

> List current custom pricing rows for LLM and non-LLM usage.

Returns the latest custom pricing rows for the authenticated builder. This endpoint requires an Admin API key.

## Request

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

## Response

```json theme={null}
{
  "entries": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "provider": null,
      "model": null,
      "metric": "search_requests",
      "price_per_unit_usd": 0.01,
      "input_per_1m_usd": null,
      "output_per_1m_usd": null,
      "effective_from": "2026-06-11T00:00:00.000Z",
      "effective_to": null,
      "source": "builder_manual",
      "notes": "Search API list price.",
      "created_at": "2026-06-11T00:00:00.000Z",
      "updated_at": "2026-06-11T00:00:00.000Z"
    }
  ]
}
```

## Notes

* Results are limited to the authenticated builder.
* Rows are ordered by newest creation time first.
* Use stable effective dates before relying on pricing for billing.
