# French Lobbying Public Profile

Checks the HATVP public lobbying register by French company identifier and extracts declared topics.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/lobbying`
- 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

- Find the public lobbying profile declared for a French organization.
- You need the public HATVP lobbying-register profile associated with a French organization.
- You want declared lobbying topics, domains or clients when exposed by that public source.

## Avoid when

- You need ordinary company identity, directors or ownership information; use company/fr/profile or company/fr/directors.
- You need lobbying information not covered by the French HATVP public register.

## Limitations

- Coverage is limited to declarations exposed by the HATVP public lobbying dataset.
- A missing record does not prove that an organization has never undertaken any influence-related activity.

## Example queries

- Find the public lobbying profile declared for a French organization.

## Freshness

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

## Sources

- [API Recherche d’entreprises](https://recherche-entreprises.api.gouv.fr)
- [HATVP lobbying register](https://www.hatvp.fr)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "French company identifier: 9-digit SIREN or 14-digit SIRET."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier"
    ],
    "description": "Structured input parameters for the company/fr/lobbying API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "description": "Identifier supplied for the request, echoed in normalized form when applicable."
        },
        "exists": {
            "type": "boolean",
            "description": "Whether the requested company or public record was found in the checked source."
        },
        "siren": {
            "type": [
                "string",
                "null"
            ],
            "description": "Normalized 9-digit French SIREN when available."
        },
        "name": {
            "type": [
                "string",
                "null"
            ],
            "description": "Publicly available company, person, buyer or record name for this result."
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok",
                "unavailable",
                "not_queried"
            ],
            "description": "Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried)."
        },
        "registered": {
            "type": [
                "boolean",
                "null"
            ],
            "description": "Structured value returned for “registered” as defined by this API contract."
        },
        "declared_name": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “declared name” as defined by this API contract."
        },
        "registration_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “registration date” as defined by this API contract."
        },
        "activity_topics": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Structured value returned for “activity topics” as defined by this API contract."
        },
        "domains": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Structured value returned for “domains” as defined by this API contract."
        },
        "clients": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Structured value returned for “clients” as defined by this API contract."
        },
        "source_json_url": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “source json url” as defined by this API contract."
        },
        "checked_at": {
            "type": "string",
            "description": "UTC timestamp at which HelpMyAgent performed the check."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "source_status",
        "registered",
        "declared_name",
        "registration_date",
        "activity_topics",
        "domains",
        "clients",
        "source_json_url",
        "checked_at"
    ],
    "description": "Structured result returned by the company/fr/lobbying 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/lobbying
- Generated at: 2026-09-07T14:50:07+00:00

## Request example

```json
{
    "identifier": "356000000"
}
```

## Stored response example

```json
{
    "identifier": "356000000",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "source_status": "ok",
    "registered": true,
    "declared_name": "LA POSTE",
    "registration_date": null,
    "activity_topics": [
        "0",
        "Développer des usages de l'identité numérique de La Poste",
        "Organiser des discussions informelles ou des réunions en tête-à-tête",
        "Transmettre aux décideurs publics des informations, expertises dans un objectif de conviction",
        "Promouvoir les services de La Poste Santé et Autonomie, notamment sur la détection de la perte d'autonomie au domicile",
        "Promouvoir l'externalisation du service de portage de repas",
        "Obtenir une juste compensation des missions de Service public de La Poste",
        "Transmettre des suggestions afin d'influencer la rédaction d'une décision publique",
        "Echanger sur l'avenir du programme France Services et son financement",
        "Autres : à préciser",
        "échanges avec l'Agence nationale de la cohésion des territoires (ANCT)",
        "Trouver des solutions aux difficultés de logement des Postiers sur certaines partie du territoire"
    ],
    "domains": [
        "Economie",
        "Pouvoirs publics et institutions",
        "Numérique",
        "Emploi, solidarité",
        "Santé",
        "Société",
        "Transports, logistique",
        "Finances publiques",
        "Construction, logement, aménagement du territoire",
        "Concurrence, consommation",
        "Environnement"
    ],
    "clients": [],
    "source_json_url": "https://www.hatvp.fr/agora/356000000.json",
    "checked_at": "2026-09-07T16:50:07+02:00",
    "limitations": [
        "Le répertoire HATVP décrit les déclarations publiques des représentants d’intérêts.",
        "registered=false signifie qu’aucune fiche exploitable n’a été trouvée ; registered=null signifie que le contrôle n’a pas pu être effectué de façon fiable."
    ]
}
```

## Billing policy

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