French company lookup in the official SIRENE register (Annuaire des Entreprises)

French company lookup in the official SIRENE register (Annuaire des Entreprises) by SIREN, SIRET or company name. Returns legal name, active/ceased status, legal form, creation date, head-office address and NAF activity code in a schema shared across countries.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://companies.use.x402atlas.com/french-company-data

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "query": "552032534"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "query": {
              "description": "Company registration number (French SIREN or SIRET, e.g. 552032534) or company name",
              "maxLength": 200,
              "minLength": 3,
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "companies": {
              "description": "Matching companies; empty when nothing matched (still HTTP 200)",
              "items": {
                "properties": {
                  "activities": {
                    "description": "Up to 5 registered activities, main activity first when the registry marks one; empty when none are published",
                    "items": {
                      "properties": {
                        "code": {
                          "description": "Registry activity code (NACE, NAF or SIC, as the registry publishes it)",
                          "type": "string"
                        },
                        "description": {
                          "description": "Activity description; null when the registry supplies only the code",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "description"
                      ],
                      "type": "object"
                    },
                    "maxItems": 5,
                    "type": "array"
                  },
                  "address": {
                    "description": "Registered (head-office) address; each part is null when the registry does not supply it",
                    "properties": {
                      "city": {
                        "description": "City or post town",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "country_code": {
                        "description": "ISO 3166-1 alpha-2 country code of the address",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "postal_code": {
                        "description": "Postal code",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "street": {
                        "description": "Street and house number",
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "street",
                      "postal_code",
                      "city",
                      "country_code"
                    ],
                    "type": "object"
                  },
                  "founded": {
                    "description": "Founding / registration date (YYYY-MM-DD)",
                    "format": "date",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "legal_form": {
                    "description": "Legal form as the registry names it, or the registry's legal-form code when it publishes no name",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "description": "Current legal name",
                    "type": "string"
                  },
                  "registration_number": {
                    "description": "Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO)",
                    "type": "string"
                  },
                  "status": {
                    "description": "Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown",
                    "enum": [
                      "active",
                      "inactive",
                      "unknown"
                    ],
                    "type": "string"
                  },
                  "website": {
                    "description": "Company website as registered; may lack a URL scheme",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "name",
                  "registration_number",
                  "status",
                  "legal_form",
                  "founded",
                  "address",
                  "activities",
                  "website"
                ],
                "type": "object"
              },
              "maxItems": 5,
              "type": "array"
            },
            "count": {
              "description": "Number of entries in companies",
              "type": "integer"
            },
            "country": {
              "description": "ISO 3166-1 alpha-2 co

This page as JSON