Compass DocsBy Mesa
Open App

🔌 API Overview

The Compass API brings the same people-first data you see in the app into your own systems. Find the right person, see how you are connected to them, and pull what you need to reach them, over a simple REST interface.

Most data APIs hand you protocol metrics or token prices. The Compass API hands you people: verified contacts, the teams they work on, and the connections between them.

Status: private beta. The endpoints are built and live, but access is granted per account while we open up. Until your account is enabled, calls to compass.mesa.so/api/v1 return a Cloudflare Access challenge. Request access through your account.

What you can do with it

  • Confirm a key. GET /v1/me returns the account, plan, and credit balance behind a key. Free.
  • Search and read people, projects, and funds. Pull the right person or team into your own CRM or tooling, with the same filters as the app. See Data Endpoints.
  • Reveal contact channels. Read a person's telegram, email, and LinkedIn through a metered, permanent unlock.
  • Cross search. One query across projects and people.

The connections graph (the app's Network view) is planned. See Roadmap & Availability.

How it works at a glance

  • REST and JSON. Predictable paths, JSON request and response bodies.
  • Versioned. Endpoints live under /api/v1, and every response carries a Compass-API-Version header (currently 1.1.1).
  • Key authenticated. Every call carries a bearer key. See Authentication & API Keys.
  • Billed in credits. A data call costs 5 credits, a private contact reveal costs 10, and /v1/me is free. Credits come from your plan. See Pricing & Quotas.
  • Base URL. https://compass.mesa.so.

Who it is for

Service providers, business development teams, and anyone running their own pipeline who wants Compass data where their work already happens. Building an autonomous agent? Start at For AI Agents.

Getting access

Any account can create a key and call /v1/me for free. On a free key, data calls return marked sample data (synthetic, 0 credits) so you can build your integration; live data needs credits from a paid plan (start with Starter, $49). The API is rolling out from behind Cloudflare Access — confirm /v1/me returns JSON before depending on live calls.

Start here