French Company KYB Batch

Runs the existing public-data KYB dossier for 2 to 10 French company identifiers.

0.100 USD

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

When to use this API?

Use for

  • Screen a batch of French suppliers with the public-data KYB dossier.

Avoid when

  • You have only one company; use company/fr/intelligence with the KYB sections profile, directors, financials, risk and compliance.
  • You specifically need VAT or IBAN consistency checks during supplier onboarding; use company/fr/supplier-verification.

Limitations

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

Sources and provenance

HelpMyAgent public-data composition

helpmyagent.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
identifiersarray

Required

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifiers": {
            "type": "array",
            "items": {
                "type": "string",
                "pattern": "^[0-9]{9}([0-9]{5})?$"
            },
            "minItems": 2,
            "maxItems": 10,
            "uniqueItems": true
        }
    },
    "additionalProperties": false,
    "required": [
        "identifiers"
    ]
}
Output schema
requested_countinteger

Required

completed_countinteger

Required

failed_countinteger

Required

resultsarray

Required

checked_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "requested_count": {
            "type": "integer"
        },
        "completed_count": {
            "type": "integer"
        },
        "failed_count": {
            "type": "integer"
        },
        "results": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "identifier": {
                        "type": "string"
                    },
                    "status": {
                        "type": "string"
                    },
                    "data": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": true
                    },
                    "error": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "additionalProperties": false,
                "required": [
                    "identifier",
                    "status",
                    "data",
                    "error"
                ]
            }
        },
        "checked_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "requested_count",
        "completed_count",
        "failed_count",
        "results",
        "checked_at"
    ]
}

Example queries

Screen a batch of French suppliers with the public-data KYB dossier.