Insolvency API reference
Your usageYour plan, the calls you have used and when they reset. Never counted.
Every planMCP tool: my_usage
The call
Your plan, the calls you have used and when they reset. Never counted.
Try it
Kept in this browser and filled in on every documentation page.
Calls the API from this browser with your key.
Parameters
This endpoint takes no parameters.
What comes back
One record in data, with these fields. Paging and counts are in meta; see Pagination.
FieldTypeWhat it holds
keyobjectprefix: your key's first characters, never the key.plantextYour plan.plan_nametextIts name.callsobjecttoday and this_month, counted in UTC.limitsobjectper_minute, per_day, per_month, limit_max.resetsobjectWhen the day and month reset.reads_fromdate, or nullThe earliest date your plan reads, or null for everything.paid_fieldstrue or falseWhether paid fields are filled.countrieslistCountries covered.An example answer
A real answer from this morning’s data, made by the call Try it opens on.
Example answerCopy
{
"data": {
"key": {
"prefix": "ik_live_4f9c"
},
"plan": "intel",
"plan_name": "Intel",
"calls": {
"today": 0,
"this_month": 2
},
"limits": {
"per_minute": 300,
"per_day": null,
"per_month": 100000,
"limit_max": 100
},
"resets": {
"day": "2026-11-01T00:00:00Z",
"month": "2026-11-01T00:00:00Z"
},
"reads_from": null,
"reads_to": null,
"paid_fields": true,
"includes": null,
"held_back": null,
"countries": [
"gb",
"fr",
"at",
"cz",
"ee",
"fi",
"hr",
"ie",
"lv",
"no",
"pt",
"ro",
"sk",
"es",
"se",
"pl",
"us",
"lt",
"de",
"ch",
"ua",
"si",
"kr"
]
},
"meta": {}
}Errors it can return
400bad_requestA value is wrong, such as a date in another format. The message says which.401unauthorizedThe key is missing, wrong or no longer valid.422unknown_parameterA parameter this endpoint does not take. The answer lists the ones it does.429rate_limitedToo many calls in one minute. Wait for the seconds in Retry-After.