Skip to main content

Search Entities

Search for legal entities across supported jurisdictions using a name or identifier.

This endpoint returns a list of matching legal entities using the standardized G-BRIS format.

Method & URL​

GET https://api.gbris.com/api/entity

Query Parameters​

NameTypeRequiredDescription
querystringYesThe search term. Can be a name or registry identifier, depending on match_condition.
country_codestringNoOptional ISO 3166-1 alpha-2 country code to limit the search.
match_conditionstringNoOne of name or identifier. Defaults to matching against all fields.

Example Request​

curl -X GET "https://api.gbris.com/api/entity?query=star&country_code=de" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example Response​

{
  "entities": [
    {
      "persistent_id": "c338d773ad8595ad1e63dc4651854e50",
      "alternate_persistent_ids": null,
      "name": "Bright Star Company GmbH",
      "country_code": "DE",
      "incorporation_date": "2020-04-20",
      "legal_form_classifier": {
        "key": "de_gmbh",
        "meta": {
          "country_code": "DE",
          "name": "Gesellschaft mit beschränkter Haftung",
          "short_name": "GmbH"
        }
      },
      "status": "ACTIVE",
      "identifiers": [
        {
          "value": "HRB1",
          "classifier": {
            "key": "de_reg",
            "category": "reg_code",
            "meta": {
              "country_code": "DE",
              "name": "Commercial Register",
              "jurisdiction": "Flensburg"
            }
          }
        }
      ],
      "addresses": [
        {
          "city": "Flensburg",
          "country_code": null,
          "full_address": "Behmstr. 7, Flensburg, Schleswig-Holstein, 24941",
          "region": "Schleswig-Holstein",
          "street_address": "Behmstr. 7",
          "type": "legal",
          "zip": "24941"
        }
      ],
      "documents": [
        {
          "title": "Annual report with financial statements",
          "language": "de",
          "format": "pdf",
          "price_eur": "15.00",
          "product_code": "DE_GMBH_ANNUAL_REPORT_EN",
          "year": 2023
        }
      ],
      "validation_date": "2024-09-11"
    }
  ]
}

Notes​

  • The response always includes an entities array. If no matches are found, the array will be empty.
  • Each entity follows the Standardized Data Format.
  • Fields like identifiers and legal_form_classifier use the Classifier System for consistent value representation.