Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from NORTHDATA_API_KEY is sent as the X-Api-Key header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. Get a North Data Premium account with API access: The Data API is part of North Data’s paid Data Services. Request access (a trial can be arranged) at https://www.northdata.de/_data or via sales.
  2. Obtain your API key: After activation you receive an API key in the format XXXX-XXXX from North Data.
  3. Set the environment variable: Set NORTHDATA_API_KEY in your .env. The key is sent as the X-Api-Key HTTP header on every request.
  4. Verify access: Run Get Company with name=‘<a known company>’ and address=‘<its city>’ and confirm a JSON profile is returned.

​
Provider notes

  • Only successful queries are billed; search endpoints are billed per unique company returned - keep power search filters narrow
  • In Germany, company name plus city uniquely identify a company; alternatively use registerId + registerCity (e.g. ‘HRB 12345’ + ‘Hamburg’)
  • The API serves JSON by default and is also reachable under www.northdata.com with the same paths
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as north-data__search_companies with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.