# New French Companies

Lists French legal units created in a requested date window using the official historized Sirene source.

## Endpoint

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

- You need French legal units created during a recent or historical date window.

## Avoid when

- You need BODACC publication events rather than Sirene creation dates; use company/fr/events or legal-announcements-search.

## Limitations

- Creation date is the Sirene legal-unit creation date and is not the same as a BODACC publication date.
- The requested window is limited to 366 days per call.
- A cursor is bound to its date-window query and should only be reused to continue that same query.

## Freshness

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

## Sources

- [INSEE — API Sirene 3.11](https://api.insee.fr/api-sirene/3.11)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "since": {
            "type": "string",
            "format": "date",
            "description": "Inclusive start date; defaults to a 7-day window"
        },
        "until": {
            "type": "string",
            "format": "date",
            "description": "Inclusive end date; defaults to today"
        },
        "cursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "default": "*",
            "description": "Opaque Sirene cursor from next_cursor; omit it on the first call"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 25,
            "description": "Maximum results to return, up to 100"
        }
    },
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/new API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "since": {
            "type": "string",
            "description": "Structured value returned for “since” as defined by this API contract."
        },
        "until": {
            "type": "string",
            "description": "Structured value returned for “until” as defined by this API contract."
        },
        "cursor": {
            "type": "string",
            "description": "Structured value returned for “cursor” as defined by this API contract."
        },
        "next_cursor": {
            "type": [
                "string",
                "null"
            ],
            "description": "Structured value returned for “next cursor” as defined by this API contract."
        },
        "limit": {
            "type": "integer",
            "description": "Structured value returned for “limit” 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."
        },
        "companies": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "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."
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "active",
                            "closed",
                            null
                        ],
                        "description": "Normalized endpoint or source status. (allowed values: active, closed)."
                    },
                    "creation_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “creation date” as defined by this API contract."
                    },
                    "closure_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “closure date” as defined by this API contract."
                    },
                    "activity_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “activity code” as defined by this API contract."
                    },
                    "legal_form_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “legal form code” as defined by this API contract."
                    },
                    "employee_band_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “employee band code” as defined by this API contract."
                    },
                    "employee_band_year": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “employee band year” as defined by this API contract."
                    },
                    "company_category": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “company category” as defined by this API contract."
                    },
                    "last_processed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “last processed at” as defined by this API contract."
                    },
                    "periods_count": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Structured value returned for “periods count” as defined by this API contract."
                    }
                },
                "required": [
                    "siren",
                    "name",
                    "status",
                    "creation_date",
                    "closure_date",
                    "activity_code",
                    "legal_form_code",
                    "employee_band_code",
                    "employee_band_year",
                    "company_category",
                    "last_processed_at",
                    "periods_count"
                ],
                "additionalProperties": false
            },
            "description": "Structured company records returned by the endpoint."
        }
    },
    "required": [
        "since",
        "until",
        "cursor",
        "next_cursor",
        "limit",
        "total_count",
        "returned_count",
        "truncated",
        "companies"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/new API."
}
```

## Request example

```json
{
    "since": "2026-09-01",
    "until": "2026-09-07",
    "limit": 25
}
```

## Billing policy

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