> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prontiq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits

> How Prontiq credits are consumed and reported in API responses.

Prontiq usage is measured in **credits**. Credits are the customer-facing unit
used for API work. Different endpoints can consume different credit amounts.

## When credits are consumed

A request becomes billable after it passes API-key authentication, product
access checks, burst-rate limits, and plan/quota enforcement, and Prontiq
accepts it for endpoint processing.

Requests rejected before admission do not consume credits. This includes
missing or invalid API keys, products not included in your plan, burst-rate-limit
rejections, and hard-cap quota rejections.

Once admitted, a request may consume credits even if endpoint processing later
returns a validation error, no match, or an API error. If you believe credits
were consumed incorrectly during an incident, contact support.

## Endpoint credit costs

{/* Generated from BILLING_ENDPOINTS. Do not edit manually. */}

| Endpoint                                          | API path                          | Credits |
| ------------------------------------------------- | --------------------------------- | ------: |
| [Autocomplete](/api-reference/autocomplete)       | `GET /v1/address/autocomplete`    |       1 |
| [Validate](/api-reference/validate)               | `GET /v1/address/validate`        |       1 |
| [Enrich](/api-reference/enrich)                   | `GET /v1/address/enrich`          |       3 |
| [Reverse geocode](/api-reference/reverse)         | `GET /v1/address/reverse`         |       2 |
| [Postcode lookup](/api-reference/postcode-lookup) | `GET /v1/address/lookup/postcode` |       1 |
| [Suburb lookup](/api-reference/suburb-lookup)     | `GET /v1/address/lookup/suburb`   |       1 |

For plan, invoice, and payment state, see the [Billing guide](/guides/billing).
For traffic protection behaviour, see [Rate Limits & Quotas](/guides/rate-limits).

## Usage and billing totals

Usage appears in Prontiq first. Billing totals and invoices can take a few
minutes to catch up while billing events settle.

Do not build customer billing records from API response headers. Use the console
for billing records and invoices.

## Response headers

Data API responses can include usage and quota headers.

| Header                  | Description                                                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `X-Request-Id`          | Unique request identifier for support and debugging.                                                                               |
| `X-RateLimit-Product`   | API family whose request-time credit counter was updated.                                                                          |
| `X-RateLimit-Reset`     | Timestamp when the current enforcement window resets, when applicable.                                                             |
| `X-RateLimit-Limit`     | Included-credit threshold for keys with a current threshold, when applicable.                                                      |
| `X-RateLimit-Remaining` | Credits remaining in the current enforcement window, when applicable.                                                              |
| `X-RateLimit-Over`      | `true` when a request succeeded as overage after the current threshold was exceeded.                                               |
| `X-Payment-Overdue`     | `true` when the account currently has an overdue billing state. Request handling still follows the active plan enforcement policy. |

<Info>
  Header presence depends on the active account state and endpoint. Use `X-Request-Id` or
  `error.request_id` when contacting support about a specific request.
</Info>

## Where to manage billing

<CardGroup cols={2}>
  <Card title="Account billing" icon="receipt" href="https://console.prontiq.dev/billing">
    Signed-in users can see account-specific billing and usage in the console.
  </Card>

  <Card title="Billing support" icon="life-ring" href="https://prontiq.featurebase.app">
    Raise a support ticket for billing, invoice, or account questions.
  </Card>
</CardGroup>