> Reverse Contact API documentation. This is the Markdown copy of https://docs.reversecontact.com/
> Every page is listed at https://docs.reversecontact.com/llms.txt, every endpoint with its credit cost and status at https://docs.reversecontact.com/catalog.json

# Build with the Reverse Contact API

> Build with the Reverse Contact API: search, enrich and fetch people and company data via REST, TypeScript and Python SDKs, an MCP server for AI agents, or CLI.

- Last verified: 2026-10-15

Search, enrich and fetch people and company data from one REST API, or through the SDKs, an MCP server for AI agents and the rc CLI.

- [Get started](https://docs.reversecontact.com/getting-started)
- [Browse use cases](https://docs.reversecontact.com/use-cases)

**cURL**

```bash
curl -X POST https://api.reversecontact.com/v2/enrich/persons \
  -H "Authorization: Bearer $RC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane.doe@acme.com"}'
```

**TypeScript SDK**

```typescript
import ReverseContact from "@reverse-contact/sdk";

// Reads RC_API_KEY from the environment.
const client = new ReverseContact();
const result = await client.enrich.person({
  email: "jane.doe@acme.com"
});

console.log(result?.data.person?.firstName);
```

**Python SDK**

```python
from reversecontact import ReverseContact

# Reads RC_API_KEY from the environment.
with ReverseContact() as client:
    result = client.enrich.person(
        email="jane.doe@acme.com"
    )
    if result and result.data and result.data.person:
        print(result.data.person.first_name)
```

**CLI**

```bash
# Reads RC_API_KEY or your saved rc login.
rc enrich person --email jane.doe@acme.com
```

- Credits: 2 credits when a person is found, full profile included. A 404 is free.

## Four ways in

- [REST API](https://docs.reversecontact.com/api-reference): Plain HTTPS from any language: a Bearer key, JSON in and out. `api.reversecontact.com/v2`
- [SDKs](https://docs.reversecontact.com/sdk/javascript): Typed clients for TypeScript and Python, with safe retries and task waiting. `npm · pip`
- [AI agents](https://docs.reversecontact.com/ai-agents): Claude, ChatGPT or Cursor call the API through the MCP server. `api.reversecontact.com/mcp`
- [CLI](https://docs.reversecontact.com/guides/cli): rc in your terminal and scripts, with a skill for coding agents. `rc enrich person`

## From API key to production

1. [Get a key](https://docs.reversecontact.com/authentication) (Get started): Create a key, send it as a Bearer token.
2. [Make your first call](https://docs.reversecontact.com/guides/first-api-call) (Get started): One request, one profile, one response to read.
3. [Pick your endpoints](https://docs.reversecontact.com/guides/which-endpoint-should-i-use) (Get started): Enrich, fetch, search or contact.
4. [Handle async results](https://docs.reversecontact.com/guides/polling) (Async results): Live lookups, emails and phones answer later.
5. [Control credits and limits](https://docs.reversecontact.com/guides/credits) (Credits & limits): What each call costs, how fast you can go.
6. [Go to production](https://docs.reversecontact.com/guides/errors-retries) (Go to production): Retry what is safe, then run the checklist.

## What do you want to do?

- [Find a person from an email, a name or a profile URL](https://docs.reversecontact.com/use-cases/find-a-person): 1 to 2 credits · live charged at task creation
- [Get a work email or a phone number](https://docs.reversecontact.com/use-cases/get-a-work-email-or-phone): email lookup from 3 credits when found · verification 1 credit
- [Build a list of people](https://docs.reversecontact.com/use-cases/build-a-list-of-people): 1 credit per profile · Agentic +1 per page · count is free
- [Find a company from a domain or a page URL](https://docs.reversecontact.com/use-cases/find-a-company): 1 to 2 credits · live charged at task creation
- [Enrich up to 25,000 people in one request](https://docs.reversecontact.com/guides/bulk-enrichment): priced like the unit calls
- [Keep profiles fresh](https://docs.reversecontact.com/use-cases/keep-profiles-fresh): status checks are free · 2 credits per live request
- [All use cases](https://docs.reversecontact.com/use-cases)

## Keep up

- [What's changing](https://docs.reversecontact.com/changes): Retirements and changes that ask you to act, by state.
- [API changelog](https://docs.reversecontact.com/changes#changelog): New endpoints, improvements, fixes and deprecations, release by release.
- [Data Coverage & Performance](https://docs.reversecontact.com/data-coverage): What the database covers, and how fast each endpoint answers.