# French director mandates

Searches public French company director mandates by name. Name matching can include homonyms and does not prove identity.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/director-mandates`
- Price: `0.010 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- Searches public French company director mandates by name. Name matching can include homonyms and does not prove identity.
- You know a director name and want public French company mandates associated with that name.
- You need candidate company links before manually resolving a person’s identity.

## Avoid when

- You already know the company and need its current listed directors; use company/fr/directors.
- You need identity proof, beneficial ownership or personal contact information.

## Limitations

- Name-based matching can include homonyms and does not prove that records refer to the same natural person.
- Returned mandates depend on the public company records available to the source.

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [https://recherche-entreprises.api.gouv.fr](https://recherche-entreprises.api.gouv.fr)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "last_name": {
            "type": "string",
            "minLength": 2,
            "description": "Director family name to search in public French company mandates; name matching can include homonyms. (minimum length 2)."
        },
        "first_names": {
            "type": "string",
            "description": "Optional first name or given names used to narrow director-mandate matches."
        },
        "page": {
            "type": "integer",
            "minimum": 1,
            "default": 1,
            "description": "One-based result page number. (minimum 1; default 1)."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 25,
            "description": "Maximum number of records returned by this call. (minimum 1; maximum 25; default 25)."
        }
    },
    "required": [
        "last_name"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/director-mandates API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "last_name": {
            "type": "string",
            "description": "Structured value returned for “last name” as defined by this API contract."
        },
        "first_names": {
            "description": "Structured value returned for “first names” as defined by this API contract."
        },
        "page": {
            "type": "integer",
            "description": "Structured value returned for “page” as defined by this API contract."
        },
        "limit": {
            "type": "integer",
            "description": "Structured value returned for “limit” as defined by this API contract."
        },
        "total_companies": {
            "type": "integer",
            "description": "Structured value returned for “total companies” as defined by this API contract."
        },
        "returned_mandates": {
            "type": "integer",
            "description": "Structured value returned for “returned mandates” as defined by this API contract."
        },
        "mandates": {
            "type": "array",
            "description": "Structured value returned for “mandates” as defined by this API contract."
        },
        "limitations": {
            "type": "array",
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "last_name",
        "first_names",
        "page",
        "limit",
        "total_companies",
        "returned_mandates",
        "mandates"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/director-mandates API."
}
```

## Demonstration snapshot

This example is a database-stored snapshot and does not execute the live API.
- URL: https://api.helpmyagent.com/demo/company/fr/director-mandates
- Generated at: 2026-09-07T14:49:30+00:00

## Request example

```json
{
    "last_name": "MARTIN",
    "page": 1,
    "limit": 5
}
```

## Stored response example

```json
{
    "last_name": "MARTIN",
    "first_names": null,
    "page": 1,
    "limit": 5,
    "total_companies": 10000,
    "returned_mandates": 0,
    "mandates": [],
    "limitations": [
        "La recherche porte sur les dirigeants publiquement exposés par l’API Recherche d’entreprises.",
        "Un rapprochement par nom peut produire des homonymes ; first_names permet d’affiner sans constituer une preuve d’identité."
    ]
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```
