---
title: "List published credit prices"
method: GET
path: "/billing/credit-prices/"
tags: ["billing"]
---

# List published credit prices

`GET /billing/credit-prices/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/billing/credit-prices/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The unit price of each billable operation, in credits, plus the dollar value of a credit. Code-defined and identical for every organization: this is what the plan page's usage calculator quotes from.

## Response `200`

Successful Response

- CreditPricesReadSchema: The published unit prices behind the plan page's usage calculator. Every figure is read from what the charge sites bill, converted to decimal credits at this boundary, so a quote can never drift from a bill. A waterfall's figure is what an answered row usually costs: each row is charged the price of the provider that answered it.
  - `ai_tiers` CreditPriceAiTierReadSchema[], required: The AI tiers, cheapest first.
    - `ai_writing_credits` number, required: The most one generated piece of copy costs: the tier's base, for ONE completion, not a whole sequence.
    - `company_research_credits` number, required: The most one researched record costs when the agent may browse the web: the tier's base plus its web-research add-on. A record is charged what its research used, never more.
    - `display_name` string, required: The tier's user-facing effort name, e.g. 'Medium'.
    - `key` string, required: The model catalog key, e.g. 'core'.
  - `cents_per_credit` number, required: The dollar value of one credit, in cents.
  - `find_email_credits` number, nullable, required: Expected credits to find one work email across the provider waterfall. Only the winning provider bills. None when this deployment has no email-finding provider registered.
  - `find_phone_credits` number, nullable, required: Expected credits to find one direct phone number across the provider waterfall. Only the winning provider bills. None when this deployment has no phone-finding provider registered.
  - `send_email_credits` number, required: Credits per accepted outbound send. Failed sends never bill.
  - `verify_email_credits` number, nullable, required: Expected credits to verify one email address across the provider waterfall. None when no verification provider is registered.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)