Authentication

The AggKnowledge API uses API keys to authenticate requests. API keys are issued and managed by your AggKnowledge account team. All API requests must include your key in the x-api-key header.

A missing or malformed key is rejected with 400 (“Malformed API key”); a well-formed key that isn’t valid — unknown, disabled, or revoked — receives 401 Unauthorized.

x-api-key header

curl --request POST \
  --url https://api.aggknowledgeai.com/v2/live/person/enrich \
  --header 'x-api-key: YOUR_API_KEY'

A valid key authenticates you; which endpoints it may call is decided by your entitlements.

Warning: Your API keys carry significant privileges, so be sure to keep them secure. Do not share your API keys in publicly accessible areas such as GitHub, client-side code, or anywhere else they could be exposed.