Compass DocsBy Mesa
Open App

🔌 API Overview

The Compass API saves your systems the same hours of research. 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.

Live and open to every account. Mint a key in Settings > API and call https://api.compass.mesa.so/v1/me to confirm it. That call is free and lists every endpoint with its credit price.

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, funds, and service providers. 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.

A connections graph endpoint 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 /v1, and every response carries a Compass-API-Version header (currently 1.4.0).
  • 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, referral bonuses, or email/telegram verification rewards. See Pricing & Quotas.
  • Base URL. https://api.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. Data calls return marked sample data (synthetic, 0 credits) only when your balance is too low to cover the call; an account with enough credits — including free-tier accounts with bonus credits — receives live data billed against that balance. For a monthly credit grant, start with Essential ($49).

Start here