# Pappers — Wrapped API

> **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.

> Search French companies and directors to access detailed business profiles, ownership structures, trademark information, and legal filings all in one place. Build professional networks, track company leadership, and monitor business intelligence across France's official registry data.

**Category:** Business Directories | **Website:** [pappers.fr/](https://pappers.fr/) | **Docs:** [parse.bot/marketplace/d5cf9ada-bd7e-451c-9282-0bde29b5f1b4/pappers-fr-api](https://parse.bot/marketplace/d5cf9ada-bd7e-451c-9282-0bde29b5f1b4/pappers-fr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_details

Get detailed profile of a French company by SIREN number. Returns registration details, share capital, headquarters address, legal form, and director information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `siren` | string | Yes | 9-digit SIREN number of the company. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/get_company_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"siren":"<string>"}'
```

### get_director_cartography

Get the professional network cartography of a director, showing linked persons and companies as a graph. Birth date in MM/YYYY format is strongly recommended for accurate matching; without it the API may return a server error if the director cannot be uniquely identified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `birth_date` | string | No | Birth date in MM/YYYY format (e.g. 04/1974). Strongly recommended for disambiguation. |
| `director_id` | string | No | Internal director ID from search_directors results for precise matching. |
| `first_name` | string | Yes | Director's first name. |
| `name` | string | Yes | Director's last name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/get_director_cartography \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"<string>","director_id":"<string>","first_name":"<string>","name":"<string>"}'
```

### search_companies

Search for French companies by name, SIREN, or keyword. Returns a paginated list of companies with identifiers, legal form, status, location, directors, and publications. At least one of query or siren should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 20). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword or company name. |
| `siren` | string | No | 9-digit SIREN number to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>","siren":"<string>"}'
```

### search_directors

Search for French company directors and managers by name. Returns paginated results with director details including birth date, nationality, and their associated companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 20). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Director name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/search_directors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_publications

Search for official BODACC legal publications for French companies. Returns paginated results with publication date, type, content, and associated company details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 20). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Company name or keyword to search in publications. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/search_publications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_trademarks

Search for French (INPI) and European (EUIPO) trademarks by name or registration number. Returns paginated results with trademark details including status, classes, deposants, mandataires, and events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 20). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Trademark name or registration number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pappers-fr-api-d5cf9ada/search_trademarks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```