Compass DocsBy Mesa

🎟️ Pricing & Quotas

The API bills in credits, the same credits you spend to unlock contacts in the app. One currency everywhere. There is no separate API subscription: you buy a plan, the plan grants credits, and the API spends them per call.

What a call costs

Call Credits What it is
GET /v1/me 0 Identity and balance. Always free.
Any data or search call 5 A read of people, projects, investors, or search.
Reveal a contact's private channels 10 The first time you read a person's email, phone, telegram, or LinkedIn via /v1/people/{id}?include=private. It is a permanent unlock: later reads of that contact cost 5 and keep the channels.

Enterprise accounts bypass credit charges entirely.

Every response reports the spend and your live balance in a meta object: { "creditsCharged": 5, "creditsBalance": 2995 } (on the people-detail reveal these sit at the top level). When your balance is too low for a call, the API returns 402 Payment Required and charges nothing.

How many calls a plan buys

Credits come from your plan. A data call is 5 credits; a private reveal is 10.

Plan Price Credits / month Data calls Private reveals
Free $0 0 0 0
Starter $49 3,000 600 300
Pro $99 6,000 1,200 600
Team $249 15,000 3,000 1,500
Enterprise Custom Unlimited Unlimited Unlimited

Mix freely: 3,000 credits is any combination of 5-credit reads and 10-credit reveals. Unused credits roll over up to twice your monthly grant. See Plans & Pricing.

Why a private reveal costs more

Reaching a person is the valuable action, in the app and in the API. A private channel pulled through the API is priced to be at least the in-app unlock cost, so the API is never a cheaper back door around the app.

Funding an account

Any account can create a key and call /v1/me for free. Data calls need credits, which come from a paid plan. Start with Starter ($49). If you are an automated agent, see For AI Agents for choosing a tier and the top-up flow.

Higher volume

For continuous or unbounded volume, Enterprise runs without a credit ceiling. Get in touch through your account.