# French Company Risk Reading Turns existing public risk, legal, financial and signal data into a concise written reading. ## Endpoint - Method: `POST` - URL: `https://api.helpmyagent.com/v1/company/fr/risk-reading` - Price: `0.030 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 - Get a written public-data risk reading for a French company. - You need a concise human-readable interpretation of existing public risk, legal, financial and signal data. - You want strengths, alerts and evidence summarized in French or English. ## Avoid when - You need structured legal-risk events and level only; use company/fr/risk. - You need the deterministic public-data default indicator and components; use company/fr/default-score. ## Limitations - The narrative is derived from existing HelpMyAgent public-data results and does not create new source evidence. - It is informational and must not be treated as a regulated credit or legal decision. ## Example queries - Get a written public-data risk reading for a French company. ## Freshness ```json { "mode": "source_dependent" } ``` ## Sources - [HelpMyAgent public-data composition](https://helpmyagent.com) - [BODACC open data](https://bodacc-datadila.opendatasoft.com) - [API Recherche d’entreprises](https://recherche-entreprises.api.gouv.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." }, "language": { "type": "string", "enum": [ "fr", "en" ], "default": "fr", "description": "Language used for the generated human-readable output. (default fr; allowed values: fr, en)." } }, "additionalProperties": false, "required": [ "identifier" ], "description": "Structured input parameters for the company/fr/risk-reading 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." }, "language": { "type": "string", "description": "Structured value returned for “language” as defined by this API contract." }, "verdict": { "type": "string", "description": "Normalized endpoint conclusion derived from the checked public data." }, "score": { "type": [ "number", "null" ], "description": "Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations." }, "confidence": { "type": [ "string", "null" ], "description": "Confidence indicator associated with an inferred or derived result." }, "narrative": { "type": "string", "description": "Structured value returned for “narrative” as defined by this API contract." }, "strengths": { "type": "array", "items": { "type": "string" }, "description": "Structured value returned for “strengths” as defined by this API contract." }, "alerts": { "type": "array", "items": { "type": "string" }, "description": "Structured value returned for “alerts” as defined by this API contract." }, "evidence": { "type": "object", "additionalProperties": true, "description": "Structured value returned for “evidence” as defined by this API contract." }, "generated_at": { "type": "string", "description": "UTC timestamp at which this derived result was generated." }, "limitations": { "type": "array", "items": { "type": "string" }, "description": "Known interpretation, source-coverage or freshness limitations for this result." } }, "additionalProperties": false, "required": [ "identifier", "exists", "siren", "name", "language", "verdict", "score", "confidence", "narrative", "strengths", "alerts", "evidence", "generated_at" ], "description": "Structured result returned by the company/fr/risk-reading 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/risk-reading - Generated at: 2026-09-07T14:49:47+00:00 ## Request example ```json { "identifier": "356000000", "language": "fr" } ``` ## Stored response example ```json { "identifier": "356000000", "exists": true, "siren": "356000000", "name": "LA POSTE", "language": "fr", "verdict": "low", "score": 0, "confidence": "high", "narrative": "Lecture synthétique fondée sur les données publiques disponibles ; les absences de données sont conservées comme inconnues.", "strengths": [ "Entreprise administrativement active.", "L’indicateur de risque public disponible reste bas." ], "alerts": [], "evidence": { "default_score": { "status": "ok", "data": { "identifier": "356000000", "identifier_type": "siren", "exists": true, "siren": "356000000", "name": "LA POSTE", "score": 0, "level": "low", "confidence": "high", "known_weight_percent": 85, "components": [ { "component": "company_status", "weight": 35, "value": "active", "risk_points": 0, "known": true, "explanation": "Statut administratif public de l’entreprise." }, { "component": "collective_procedures", "weight": 35, "value": 0, "risk_points": 0, "known": true, "explanation": "Présence de procédures collectives BODACC dans la fenêtre analysée ; une couverture incomplète rend cette composante inconnue." }, { "component": "revenue_trend", "weight": 15, "value": null, "risk_points": null, "known": false, "explanation": "Variation du dernier chiffre d’affaires public disponible." }, { "component": "net_margin", "weight": 15, "value": 4.98, "risk_points": 0, "known": true, "explanation": "Dernière marge nette publique calculable." } ], "limitations": [ "Ce score est un indicateur HelpMyAgent déterministe fondé uniquement sur des données publiques disponibles.", "Il ne constitue pas un credit score officiel ou réglementaire, une probabilité statistique de défaut, ni un avis financier.", "L’absence de comptes publics réduit la confiance et ne doit pas être interprétée comme un signal favorable ou défavorable." ] } }, "legal_risk": { "status": "ok", "data": { "identifier": "356000000", "identifier_type": "siren", "exists": true, "siren": "356000000", "name": "LA POSTE", "company_status": "active", "risk_level": "low", "assessment_basis": "bodacc_legal_events", "lookback_years": 10, "coverage_complete": true, "signals": { "company_closed": false, "collective_procedure_events": 0, "radiation_events": 0 }, "latest_event": null, "events": [] } }, "financials": { "status": "ok", "data": { "identifier": "356000000", "identifier_type": "siren", "exists": true, "siren": "356000000", "name": "LA POSTE", "summary": { "years_available": 1, "latest_year": "2024", "latest_revenue": 34569000000, "latest_net_income": 1722000000, "latest_revenue_growth_percent": null, "latest_net_margin_percent": 4.98 }, "financials": [ { "year": "2024", "revenue": 34569000000, "net_income": 1722000000, "revenue_growth_percent": null, "net_margin_percent": 4.98 } ] } }, "signals": { "status": "ok", "data": { "identifier": "356000000", "identifier_type": "siren", "exists": true, "siren": "356000000", "name": "LA POSTE", "lookback_days": 365, "checked_at": "2026-09-07T16:49:47+02:00", "signals_count": 2, "signals": [ { "type": "NEW_PUBLIC_CONTRACT", "date": "2026-09-02", "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": "2026PA26051", "object": "SERVICE D'ACHEMINEMENT POSTAL ET PRESTATIONS ASSOCIÉES", "nature": "Marché", "procedure": "Procédure adaptée", "cpv": "64100000-7", "amount": 115000, "duration_months": 48, "notification_date": "2026-09-02", "publication_date": "2026-09-02", "price_form": "Unitaire", "buyer": { "siret": "21280134400012", "name": null }, "execution_location": { "code": "28103", "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_at": "2026-09-07T16:49:47+02:00", "limitations": [ "Cette lecture n’est ni un credit score réglementaire, ni une recommandation de crédit, ni un avis juridique." ] } ``` ## Billing policy ```json { "charge_on": "valid_result", "no_charge_on_empty_result": true, "no_charge_on_error": true } ```