Skip to main content

Quickstart

This guide walks you through making your first request to the G-BRIS API to retrieve unified entity data from multiple registries.

Step 1: Get Access​

To use the API, you need a bearer token. See Requesting a token.

Step 2: Make Your First API Call​

You can search for an entity by name and country using the /entity endpoint.

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

This call searches for entities in Germany whose names match the string "star".

Example Response (Simplified)​

{
  "entities": [
    {
      "persistent_id": "c2338d773ad85295ad1e63d2c4651854",
      "name": "Bright Star Company GmbH"
    }
  ]
}

The actual response includes additional standardized fields such as identifiers, addresses, legal form, and available documents.

What’s Next?​

  • Authentication
    How to securely authorize API requests

  • Core Concepts
    Learn how entity resolution, data merging, and classifiers work in G-BRIS

  • API Reference
    Explore available endpoints and request/response formats