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 > 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	100

FAQ

Do unused credits roll over? Yes

What happens if I hit my limit? API responses return 429 with a “credits exhausted” message.