# Search French BODACC announcements

Searches BODACC public announcements by family, date window and/or department.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/legal-announcements-search`
- 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 BODACC public announcements by family, date window and/or department.
- You need to search BODACC announcements across companies by family, date window and/or department.
- You are building a broad legal-announcement discovery or monitoring query.

## Avoid when

- You need the event timeline of one known company; use company/fr/events.
- You are polling one company from a saved date; use company/fr/events with the since parameter.

## Limitations

- Results reflect BODACC records matching the supplied filters and the public source’s current coverage.
- Announcement records are factual source items and do not by themselves constitute legal-risk interpretation.

## Freshness

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

## Sources

- [https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records](https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "family_code": {
            "type": "string",
            "description": "Optional BODACC announcement family code used to restrict legal-announcement results."
        },
        "since": {
            "type": "string",
            "format": "date",
            "description": "Earliest publication or event date to include, in YYYY-MM-DD format."
        },
        "until": {
            "type": "string",
            "format": "date",
            "description": "Latest publication or event date to include, in YYYY-MM-DD format."
        },
        "department": {
            "type": "string",
            "description": "Optional French department code used to restrict results geographically."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 25,
            "description": "Maximum number of records returned by this call. (minimum 1; maximum 100; default 25)."
        }
    },
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/legal-announcements-search API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "criteria": {
            "type": "object",
            "description": "Structured value returned for “criteria” as defined by this API contract."
        },
        "total_count": {
            "type": "integer",
            "description": "Total number of matching records reported by the source or endpoint."
        },
        "returned_count": {
            "type": "integer",
            "description": "Number of records included in this response."
        },
        "truncated": {
            "type": "boolean",
            "description": "Whether additional matching records existed beyond the returned result limit."
        },
        "announcements": {
            "type": "array",
            "description": "Structured value returned for “announcements” as defined by this API contract."
        }
    },
    "required": [
        "criteria",
        "total_count",
        "returned_count",
        "truncated",
        "announcements"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/legal-announcements-search 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/legal-announcements-search
- Generated at: 2026-09-07T14:49:30+00:00

## Request example

```json
{
    "since": "2026-01-01",
    "department": "75",
    "limit": 5
}
```

## Stored response example

```json
{
    "criteria": {
        "family_code": null,
        "since": "2026-01-01",
        "until": null,
        "department": "75"
    },
    "total_count": 302025,
    "returned_count": 5,
    "truncated": true,
    "announcements": [
        {
            "id": "A202601701516",
            "siren": null,
            "publication_date": "2026-09-06",
            "family_code": "vente",
            "family": "Ventes et cessions",
            "notice_type": "Avis initial",
            "department": "75",
            "city": "Paris",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601701516",
            "judgment": null
        },
        {
            "id": "A202601701524",
            "siren": null,
            "publication_date": "2026-09-06",
            "family_code": "creation",
            "family": "Créations",
            "notice_type": "Avis initial",
            "department": "75",
            "city": "Paris",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601701524",
            "judgment": null
        },
        {
            "id": "A202601701538",
            "siren": null,
            "publication_date": "2026-09-06",
            "family_code": "creation",
            "family": "Créations",
            "notice_type": "Avis initial",
            "department": "75",
            "city": "Paris",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601701538",
            "judgment": null
        },
        {
            "id": "A202601701552",
            "siren": null,
            "publication_date": "2026-09-06",
            "family_code": "creation",
            "family": "Créations",
            "notice_type": "Avis initial",
            "department": "75",
            "city": "Paris",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601701552",
            "judgment": null
        },
        {
            "id": "A202601701588",
            "siren": null,
            "publication_date": "2026-09-06",
            "family_code": "creation",
            "family": "Créations",
            "notice_type": "Avis initial",
            "department": "75",
            "city": "Paris",
            "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
            "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601701588",
            "judgment": null
        }
    ]
}
```

## Billing policy

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