French Company Risk Reading

Turns existing public risk, legal, financial and signal data into a concise written reading.

0.030 USD

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

When to use this API?

Use for

  • Get a written public-data risk reading for a French company.

Avoid when

  • Use a more specific endpoint when you only need one already available primitive datum.

Limitations

  • Results depend on the availability and scope of the cited public sources.

Sources and provenance

HelpMyAgent public-data composition

helpmyagent.com

BODACC open data

bodacc-datadila.opendatasoft.com

API Recherche d’entreprises

recherche-entreprises.api.gouv.fr

Input / Output schemas

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

OpenAPI 3.1 →

Input schema
identifierstring

Required

languagestring

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$"
        },
        "language": {
            "type": "string",
            "enum": [
                "fr",
                "en"
            ],
            "default": "fr"
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier"
    ]
}
Output schema
identifierstring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

languagestring

Required

verdictstring

Required

scorenumber | null

Required

confidencestring | null

Required

narrativestring

Required

strengthsarray

Required

alertsarray

Required

evidenceobject

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "exists": {
            "type": "boolean"
        },
        "siren": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "language": {
            "type": "string"
        },
        "verdict": {
            "type": "string"
        },
        "score": {
            "type": [
                "number",
                "null"
            ]
        },
        "confidence": {
            "type": [
                "string",
                "null"
            ]
        },
        "narrative": {
            "type": "string"
        },
        "strengths": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "alerts": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "evidence": {
            "type": "object",
            "additionalProperties": true
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "language",
        "verdict",
        "score",
        "confidence",
        "narrative",
        "strengths",
        "alerts",
        "evidence",
        "generated_at"
    ]
}

Example queries

Get a written public-data risk reading for a French company.