Introduction | Kooperativa API

B2B data enrichment API for developers. Look up profiles and companies, and search our data lake by any attribute, all with a single HTTP request.

Kooperativa gives you structured B2B data via a single REST API. Look up any person or company, search profiles and companies with filters, and monitor changes with webhooks.

Base URL

https://kooperativa.io/api/v1

Authentication

Every request requires an API key passed as a Bearer token:

Authorization: Bearer ik_live_...

Generate keys from your dashboard. Keys start with ik_live_.

Credits

All endpoints cost 1 credit per request. Credits are only charged on a successful response.

Credits never expire. They stay in your account until used.

Data freshness

All data is served from our own data lake, continuously refreshed in the background. Every record exposes a fetched_at timestamp so you can tell how recent it is.

Response format

All responses are JSON. Successful responses wrap data in a data key:

{
  "data": { ... }
}

Errors return an error string with an appropriate HTTP status code:

{
  "error": "Profile not found"
}

Rate limits

Default: 1,200 requests per minute per API key.

Credit limit errors

If your workspace owner has set a personal credit limit for your account and you exceed it, you’ll receive:

{
  "error": "Credit limit reached. You have used your allocated credits for this month. Please contact your workspace owner to increase your limit."
}

Quick start

1. Check the API is upbash

curl https://kooperativa.io/api/v1/health

2. Enrich your first personbash

curl "https://kooperativa.io/api/v1/person?username=satyanadella" \
  -H "Authorization: Bearer ik_live_..."

3. Check your credit balancebash

curl https://kooperativa.io/api/v1/me \
  -H "Authorization: Bearer ik_live_..."