helpmyagent.com
FR Explore APIs

French Company Signals

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

POST https://api.helpmyagent.com/v1/company/fr/signals
$ 0.020 $ / callcharged on valid result · errors not charged
FRCoverageFR
DBDocumented sources6
{ }Structured outputJSON
⌁REST + MCPx402
$Pay per call0.020 $

When should you use this API?

Use cases and limitations are published with the API so humans and agents can integrate it correctly.

Use when

  • 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

Sources published for this endpoint are shown directly with their original link.

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

View source ↗
Données essentielles de la commande publique (DECP)

data.economie.gouv.fr:decp-2022-marches-valides

View source ↗
Agence Bio — opérateurs certifiés

opendata.agencebio.org

View source ↗
DGEFP — Liste publique des organismes de formation

dgefp.opendatasoft.com:liste-publique-des-of-v2

View source ↗

Stored real response

This snapshot is served from published database data without executing the paid API.

View full JSON →
company/fr/signalsStored demo
Request
{
    "identifier": "356000000"
}
Stored response
{
    "identifier": "356000000",
    "identifier_type": "siren",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "lookback_days": 365,
    "checked_at": "2026-09-03T17:33:15+02:00",
    "signals_count": 2,
    "signals": [
        {
            "type": "NEW_PUBLIC_CONTRACT",
            "date": "2026-08-24",
            "importance": "medium",
            "explanation": "25 marché(s) public(s) récent(s) figurent dans les données DECP retournées.",
            "source_data": {
                "recent_contracts_in_response": 25,
                "latest_contract": {
                    "id": "20262026C014",
                    "object": "DISTRIBUTION D'IMPRIMES D'INFORMATION PUBLIQUE",
                    "nature": "Marché",
                    "procedure": "Procédure adaptée",
                    "cpv": "64100000-7",
                    "amount": 60000,
                    "duration_months": 5,
                    "notification_date": "2026-08-24",
                    "publication_date": "2026-08-25",
                    "price_form": "Unitaire",
                    "buyer": {
                        "siret": "21060027600013",
                        "name": null
                    },
                    "execution_location": {
                        "code": "06800",
                        "code_type": "Code postal",
                        "name": null
                    },
                    "holder_sirets": [
                        "35600000000048"
                    ],
                    "social_considerations": "Pas de considération sociale",
                    "environmental_considerations": "Pas de considération environnementale",
                    "innovative": true,
                    "modified": null,
                    "modification_object": null,
                    "modification_amount": null,
                    "source": "data.economie.gouv.fr:decp-2022-marches-valides",
                    "source_type": "SOURCE_PUBLIQUE"
                }
            },
            "sources": [
                "company/fr/public-contracts"
            ]
        },
        {
            "type": "NEW_FINANCIAL_STATEMENT",
            "date": "2026-07-16",
            "importance": "low",
            "explanation": "Un dépôt de comptes récent est publié au BODACC.",
            "source_data": {
                "id": "C2026013311905",
                "type": "accounts_filing",
                "publication_date": "2026-07-16",
                "event_date": "2025-12-31",
                "family_code": "dpc",
                "family": "Dépôts des comptes",
                "notice_type": "Avis initial",
                "title": "Comptes consolidés et rapports",
                "description": null,
                "tribunal": "Greffe du Tribunal des Activités Economiques de paris",
                "department": "75",
                "city": "Paris",
                "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C2026013311905"
            },
            "sources": [
                "company/fr/events"
            ]
        }
    ],
    "coverage": [
        {
            "service": "profile",
            "status": "ok"
        },
        {
            "service": "financials",
            "status": "ok"
        },
        {
            "service": "risk",
            "status": "ok"
        },
        {
            "service": "events",
            "status": "ok"
        },
        {
            "service": "public_contracts",
            "status": "ok"
        },
        {
            "service": "certifications",
            "status": "ok"
        }
    ]
}
Generated : 2026-09-03T15:33:26+00:00
$Billing policy

0.020 $ / call · charged on valid result · errors not charged.

Input / Output schemas

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

OpenAPI 3.1 →
Input schema
identifierstringRequired · 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
identifierstringRequired
identifier_typestringRequired
existsbooleanRequired
sirenstring | nullRequired
namestring | nullRequired
lookback_daysintegerRequired
checked_atstringRequired
signals_countintegerRequired
signalsarrayRequired
coveragearrayRequired
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

Queries published with the API to help select the right endpoint.

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.