---
title: "The active credit price-list version and its entries (admin only)"
method: GET
path: "/v1/admin/credit-prices"
---

# The active credit price-list version and its entries (admin only)

`GET /v1/admin/credit-prices`

## Request

- Base URL: `https://api.clichefactory.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clichefactory.com/v1/admin/credit-prices`
- Auth: none declared

What checkout should quote, and which currencies we will accept.

The entries are the currency allow-list. A currency missing here is
rejected by `POST /v1/billing/credits` rather than priced from a default.

## Headers

- `X-API-KEY` string, nullable

## Response `200`

Successful Response

- CreditPriceListResponse: The price-list version currently in force, with all its entries. Django renders checkout from this and quotes ``price_list_id`` back on the webhook so the server can reject a quote made against a superseded version. The entries are also the currency allow-list: a currency absent here cannot be sold in, and adding one is a data change rather than a deploy.
  - `price_list_id` integer, required
  - `effective_from` string, date-time, required
  - `change_reason` string
  - `announced_at` string, date-time, nullable
  - `entries` CreditPriceEntryItem[]
    - `currency` string, required
    - `credits_per_unit` integer, required
    - `min_topup_minor` integer
    - `pricing_fx_rate` number, nullable
  - `functional_currency` string
  - `created_by` string, nullable
  - `note` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clichefactory/apis/aio-server.md) · [All operations](https://skmtc.dev/clichefactory/apis/aio-server/llms.txt) · [OpenAPI document](https://skmtc.dev/clichefactory/apis/aio-server/revisions/9bd59f9bbb31?raw)