---
title: "Get active billing config + full history (admin only)"
method: GET
path: "/v1/admin/billing-config"
---

# Get active billing config + full history (admin only)

`GET /v1/admin/billing-config`

## 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/billing-config`
- Auth: none declared

## Headers

- `X-API-KEY` string, nullable

## Response `200`

Successful Response

- AdminBillingConfigHistoryResponse
  - `active` BillingConfigResponse, required
    - `id` integer, required
    - `credits_per_dollar` integer
    - `price_list` 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
    - `extraction_fast_cpp` integer
    - `extraction_default_cpp` integer
    - `extraction_robust_cpp` integer
    - `extraction_fast_cpp_byok` integer
    - `extraction_default_cpp_byok` integer
    - `extraction_robust_cpp_byok` integer
    - `to_markdown_cpp` integer
    - `to_markdown_cpp_byok` integer
    - `training_base_fee_credits` integer
    - `training_byok_fee_credits` integer
    - `training_tiny_credits` integer
    - `training_mipro_min_credits` integer
    - `training_mipro_max_credits` integer
    - `training_gepa_per_metric_call` integer
    - `dspy_examples_fee_credits` integer
    - `free_extraction_pages` integer
    - `effective_from` string, date-time, required
    - `created_by` string, nullable
    - `note` string, nullable
  - `history` BillingConfigResponse[], required
    - `id` integer, required
    - `credits_per_dollar` integer
    - `price_list` 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
    - `extraction_fast_cpp` integer
    - `extraction_default_cpp` integer
    - `extraction_robust_cpp` integer
    - `extraction_fast_cpp_byok` integer
    - `extraction_default_cpp_byok` integer
    - `extraction_robust_cpp_byok` integer
    - `to_markdown_cpp` integer
    - `to_markdown_cpp_byok` integer
    - `training_base_fee_credits` integer
    - `training_byok_fee_credits` integer
    - `training_tiny_credits` integer
    - `training_mipro_min_credits` integer
    - `training_mipro_max_credits` integer
    - `training_gepa_per_metric_call` integer
    - `dspy_examples_fee_credits` integer
    - `free_extraction_pages` integer
    - `effective_from` string, date-time, required
    - `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)
