helpmyagent.com
FR Connect my AI
☰

French Company Signals

Detects explainable business signals from available French company data, including closure, insolvency, revenue changes, new filings, public contracts and certifications.

0.020 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • You need explainable business signals derived from existing public Company data rather than raw records from one source.
  • You want to detect supported signals such as closure, insolvency, revenue change, new financial filings, public contracts or certifications.

Avoid when

  • You need the underlying raw financial, BODACC, contract or certification records; call the specialized endpoint instead.
  • You need continuous monitoring or push alerts; this endpoint evaluates signals at request time and is not a subscription service.

Limitations

  • Only the signal families explicitly implemented by the endpoint are evaluated; it is not a general predictive business-risk model.
  • Coverage can be partial when one of the underlying public-data services is unavailable.

Sources and provenance

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

BODACC Open Data

bodacc-datadila.opendatasoft.com

Données essentielles de la commande publique (DECP)

www.data.economie.gouv.fr

ADEME — Liste des entreprises RGE

data.ademe.fr

Agence Bio — opérateurs certifiés

opendata.agencebio.org

DGEFP — Liste publique des organismes de formation

dgefp.opendatasoft.com

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "9-digit SIREN or 14-digit SIRET"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

lookback_daysinteger

Required

checked_atstring

Required

signals_countinteger

Required

signalsarray

Required

coveragearray

Required

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "identifier_type": {
            "type": "string",
            "enum": [
                "siren",
                "siret"
            ]
        },
        "exists": {
            "type": "boolean"
        },
        "siren": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "lookback_days": {
            "type": "integer"
        },
        "checked_at": {
            "type": "string"
        },
        "signals_count": {
            "type": "integer"
        },
        "signals": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "INSOLVENCY",
                            "REVENUE_DROP",
                            "FAST_GROWTH",
                            "NEW_FINANCIAL_STATEMENT",
                            "NEW_PUBLIC_CONTRACT",
                            "NEW_CERTIFICATION",
                            "COMPANY_CLOSED"
                        ]
                    },
                    "date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "importance": {
                        "type": "string",
                        "enum": [
                            "low",
                            "medium",
                            "high"
                        ]
                    },
                    "explanation": {
                        "type": "string"
                    },
                    "source_data": {
                        "type": "object"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    }
                },
                "required": [
                    "type",
                    "date",
                    "importance",
                    "explanation",
                    "source_data",
                    "sources"
                ],
                "additionalProperties": false
            }
        },
        "coverage": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "service": {
                        "type": "string"
                    },
                    "status": {
                        "type": "string"
                    }
                },
                "required": [
                    "service",
                    "status"
                ],
                "additionalProperties": false
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "lookback_days",
        "checked_at",
        "signals_count",
        "signals",
        "coverage"
    ],
    "additionalProperties": false
}

Example queries

What important public business signals exist for SIREN 356000000?
Has this company recently shown revenue growth, insolvency or a new public contract?
Summarize the latest explainable signals for this company.