Api Endpoint

French Company KYB Check (SIREN)

French company KYB check by SIREN or SIRET, with VAT (VIES) validation: use it to vet a supplier, customer or partner before paying, onboarding or contracting. Returns legal identity, active/closed status, revenue and net income when published, EU VAT validity, insolvency proceedings from BODACC (safeguard, receivership, liquidation), RGE/Qualiopi labels, a favorable/vigilance/defavorable verdict with sourced signal codes and a signed attestation. Official open data; errors are never charged.

Open interactive test console

Offering

Provider
api-production-24833.up.railway.app
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Legal And Compliance
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api-production-24833.up.railway.app/v1/verify
MIME type
application/json
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
KYB, kyb-france, company-verification, supplier-verification, france, business-verification

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x9f1ca575893c1F88d622BDf1CD578b810f2B878d"
  }
]

Observed health

Status
Healthy
Latest latency
112 ms
Average latency
851 ms
HTTP status
402
Last checked
Reachability
93.3% over 15 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "siren": {
          "type": "string",
          "pattern": "^([0-9]{9}|[0-9]{14})$",
          "description": "French company identifier: SIREN (9 digits, Luhn-valid) or SIRET (14 digits)."
        },
        "nom": {
          "type": "string",
          "minLength": 2,
          "maxLength": 100,
          "description": "Optional name to check against the official name (returns exacte/partielle/aucune without disclosing it)."
        }
      },
      "required": [
        "siren"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "properties": {
        "siren": {
          "type": "string"
        },
        "entreprise": {
          "type": "object",
          "properties": {
            "denomination": {
              "type": [
                "string",
                "null"
              ]
            },
            "etat": {
              "type": "string",
              "enum": [
                "active",
                "cessee",
                "inconnu"
              ]
            },
            "dateCreation": {
              "type": [
                "string",
                "null"
              ]
            },
            "ancienneteAnnees": {
              "type": [
                "number",
                "null"
              ]
            },
            "natureJuridique": {
              "type": [
                "object",
                "null"
              ]
            },
            "activite": {
              "type": "object"
            },
            "effectif": {
              "type": [
                "object",
                "null"
              ]
            },
            "siege": {
              "type": [
                "object",
                "null"
              ]
            },
            "etablissements": {
              "type": "object"
            },
            "tva": {
              "type": "object"
            },
            "labels": {
              "type": "object"
            },
            "finances": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "annee": {
                    "type": "number"
                  },
                  "chiffreAffaires": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "resultatNet": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                }
              }
            }
          }
        },
        "procedures": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "etat": {
              "type": "string",
              "enum": [
                "aucune",
                "sauvegarde_en_cours",
                "redressement_en_cours",
                "liquidation_en_cours",
                "plan_sauvegarde_en_cours",
                "plan_redressement_en_cours",
                "cloturee_insuffisance_actif",
                "cloturee_extinction_passif",
                "cloturee",
                "terminee"
              ]
            },
            "historique": {
              "type": "array",
              "items": {
                "type": "object"
              }
            }
          }
        },
        "correspondanceNom": {
          "type": [
            "object",
            "null"
          ]
        },
        "verdict": {
          "type": "object",
          "properties": {
            "niveau": {
              "type": "string",
              "enum": [
                "favorable",
                "vigilance",
                "defavorable",
                "indetermine"
              ]
            },
            "resume": {
              "type": "string"
            },
            "confiance": {
              "type": "string",
              "enum": [
                "complete",
                "partielle"
              ]
            }
          },
          "required": [
            "niveau"
          ]
        },
        "signaux": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "niveau": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "preuve": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "fraicheur": {
          "type": "string",
          "enum": [
            "temps_reel",
            "cache",
            "degradee"
          ]
        },
        "verifieLe": {
          "type": "string"
        },
        "attestation": {
          "type": "object"
        }
      },
      "required": [
        "siren",
        "entreprise",
        "procedures",
        "verdict",
        "signaux"
      ]
    }
  },
  "required": [
    "type"
  ]
}