French Supplier Verification

Combines public company, compliance and optional VAT/IBAN consistency checks into a supplier review result.

0.050 USD

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

When to use this API?

Use for

  • Review a French supplier before onboarding or payment.

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

API Recherche d’entreprises

recherche-entreprises.api.gouv.fr

European Commission VIES

ec.europa.eu

ISO 13616 checksum validation

www.iso.org

Input / Output schemas

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

OpenAPI 3.1 →

Input schema
identifierstring

Required

vat_numberstring

ibanstring

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

Required

sirenstring | null

Required

namestring | null

Required

verdictstring

Required

checksobject

Required

checked_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "siren": {
            "type": [
                "string",
                "null"
            ]
        },
        "name": {
            "type": [
                "string",
                "null"
            ]
        },
        "verdict": {
            "type": "string"
        },
        "checks": {
            "type": "object",
            "additionalProperties": true
        },
        "checked_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "identifier",
        "siren",
        "name",
        "verdict",
        "checks",
        "checked_at"
    ]
}

Example queries

Review a French supplier before onboarding or payment.