Finnish company lookup in the official PRH/YTJ Business Information System by bu

Finnish company lookup in the official PRH/YTJ Business Information System by business ID (Y-tunnus) or company name. Returns legal name, status, company form, registration date, address, main business line and website 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/finnish-company-data

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "query": "0112038-9"
  },
  "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 (Finnish business ID, e.g. 0112038-9) or company name",
              "maxLength": 200,
              "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 code of the route's country",
    

This page as JSON