Skip to main content

Authentication

All requests to the G-BRIS API must be authenticated using a bearer token.

Tokens are issued manually by the G-BRIS team.

Requesting a Token​

To request access to the API, email [email protected] and include a short description of your intended use case and expected request volumes.

Once approved, you will receive a static access token tied to your organization or integration.

Sending the Token​

Include the token in the Authorization header of your requests:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example Request​

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

Additional Notes​

  • Tokens do not expire automatically.
  • Each token is tied to a specific organization and system integration.
  • Tokens should never be hard-coded into client-side code or exposed publicly.
  • Rate limits and usage policies may apply depending on your agreement.
  • If you believe your token has been compromised, contact [email protected].