---
title: "Explain one endpoint's price"
method: GET
path: "/credits/pricing/explain"
tags: ["Catalog"]
---

# Explain one endpoint's price

`GET /credits/pricing/explain`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/pricing/explain`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Breaks one endpoint's price into base cost, percentage markup, flat markup, your margin, and the customer-visible effective price, and names which configuration level supplied each markup. Endpoints priced live per call return the honest variable shape with null money fields rather than a fabricated base.

## Query parameters

- `provider` string, required
- `endpoint` string, required
- `args` string

## Response `200`

Price breakdown

- object
  - `success` unknown, required
  - `explain` PricingExplain, required: The base-cost to effective-price translation for one endpoint, including which configuration level supplied each markup. Money fields are exact decimal strings, and are null for endpoints priced live per call.
    - `provider` string, required
    - `endpoint` string, required
    - `slug` string, required: provider/endpoint
    - `method` string, required: Upstream HTTP method.
    - `dynamic` boolean, required: true when the endpoint is metered and priced per call.
    - `estimated` boolean, required: true when baseUsd is an estimate rather than a fixed price.
    - `enabled` boolean, required
    - `creditsPerDollar` integer, required
    - `markupBps` integer, required
    - `markupSource` 'endpoint' | 'provider' | 'global', required
    - `flatSource` 'endpoint' | 'provider' | 'global', required
    - `overridden` boolean, required: true when either markup comes from a provider or endpoint override rather than the tenant default.
    - `baseUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `baseCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `markupUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `flatMarkupUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `marginUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `marginCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `effectiveUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `effectiveCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `humanSummary` string, required: One-sentence plain-language explanation of the price.

## Other responses

- `400`: provider or endpoint missing, or args is not a JSON-encoded object.
- `403`: The authenticated management credential lacks one or more required scopes
- `404`: Unknown provider or endpoint.

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)