# Clado

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Contact enrichment for lead generation, individually or as a bulk job with its own status read.

**Category:** Data Enrichment | **Website:** [clado.ai](https://clado.ai) | **Docs:** [docs.clado.ai](https://docs.clado.ai)

## Access Methods

| Method | Base URL | Auth |
|--------|----------|------|
| **MPP (Tempo)** | `https://clado.mpp.paywithlocus.com/clado/` | HTTP 402 auto-payment |
| **Locus Pro Wrapped API** | `https://api.paywithlocus.com/api/wrapped/credits/clado/` | `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` + `Idempotency-Key` |

**OpenAPI discovery:** `GET https://clado.mpp.paywithlocus.com/openapi.json`

## Endpoints

### Contact Enrichment

Get contact info (email, phone) for a person by LinkedIn URL, email, or phone.

**Estimated cost:** $0.04-$0.14

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `linkedin_url` | string | No | LinkedIn profile URL |
| `email` | string | No | Email address |
| `phone` | string | No | Phone number |
| `email_enrichment` | boolean | No | Enrich email (4 credits) |
| `phone_enrichment` | boolean | No | Enrich phone (10 credits) |

```bash
curl -X POST https://clado.mpp.paywithlocus.com/clado/contacts \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url":"https://www.linkedin.com/in/williamhgates","email_enrichment":true,"phone_enrichment":false}'
```

### Bulk Contact Enrichment

Enrich contacts in bulk by LinkedIn URLs or people IDs.

**Estimated cost:** $0.04+/contact

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `linkedin_urls` | string[] | No | LinkedIn profile URLs |
| `people_ids` | string[] | No | People IDs |
| `email_enrichment` | boolean | No | Enrich emails |
| `phone_enrichment` | boolean | No | Enrich phones |

```bash
curl -X POST https://clado.mpp.paywithlocus.com/clado/bulk-contacts \
  -H "Content-Type: application/json" \
  -d '{"linkedin_urls":["https://www.linkedin.com/in/williamhgates"],"email_enrichment":true,"phone_enrichment":false}'
```

### Bulk Contacts Status

Check the status of a bulk contact enrichment job.

**Estimated cost:** $0.003 platform fee (upstream free)

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `jobId` | string | Yes | Bulk contacts job ID |

```bash
curl -X POST https://clado.mpp.paywithlocus.com/clado/bulk-contacts-status \
  -H "Content-Type: application/json" \
  -d '{"jobId":"<from clado/bulk-contacts>"}'
```