# Usage and credits

MadKudu’s API is billed using credits, a transparent system that makes it easy to track and manage your usage as your team scales. 

A credit is our universal pricing unit. Every API call consumes a number of credits based on the data it delivers and the cost we incur to produce it. 

## How many credits does each endpoint use

| Category                 | Example Endpoints                 | Credits                                      |
| ------------------------ | --------------------------------- | -------------------------------------------- |
| Lookup                   | `POST /lookup/accounts`           | 1                                            |
| Detailed Info            | `GET /accounts/{id}`              | 3                                            |
| Search (10 results)      | `POST /search/accounts`           | 1                                            |
| Enrichment (20 postings) | `POST /enrichment/job-postings`   | 3                                            |
| Sourcing                 | `POST /sourcing/persons/discover` | **0** (as it consumes your provider credits) |
| AI Web Search            | `POST /ai/web-search`             | 5                                            |
| Organisation             | `/organization`                   | 0                                            |
| Ingestion Upload         | `/ingestion/*`                    | 0                                            |

## How to monitor usage

* Log into[ MadKudu Admin console ](https://admin.madkudu.com/) > **Settings** > **API Usage**

to view the number of credits consumes and your remaining credit balance

## What’s included in my plan

With the API access add-on you get a credit allowance. If you need more credits talk to your CSM. 

## Real world examples 

| Use-case                                       | Calls          | Credits                            |
| ---------------------------------------------- | -------------- | ---------------------------------- |
| Enrich 1 000 new sign-ups (lookup)             | 1 000 × 1      | **1 000**                          |
| Pull detailed profiles for 100 target accounts | 100 × 2        | **200**                            |
| Discover 500 net-new prospects                 | 20 batches × 5 | <p></p><p><strong>100</strong></p> |

## FAQ

**Do unused credits roll over?**\
Yes

**What happens if I hit my limit?**\
API responses return `429` with a “credits exhausted” message.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.madkudu.com/getting-started/usage-and-credits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.