North Data

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

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.

VariableRequiredDescription
NORTHDATA_API_KEYYesNorth Data API key (format XXXX-XXXX), sent as the X-Api-Key header Docs.

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

ToolAccessDescription
Search Companies<br /><code className="reference-identifier">north-data__search_companies</code>ReadSearch companies and people
Get Company<br /><code className="reference-identifier">north-data__get_company</code>ReadGet company
Power Search<br /><code className="reference-identifier">north-data__power_search</code>ReadSearch narrowly; billed per unique company
Suggest Companies<br /><code className="reference-identifier">north-data__suggest</code>ReadSuggest companies and people (unbilled)
Get Person<br /><code className="reference-identifier">north-data__get_person</code>ReadGet person (billed lookup)

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.