The Veridion API uses token-based authentication, requiring you to include your individual API key with each request.

📘

Request header

The API key must be included in a request header named x-api-key.

The API key is used to validate access to the API and enforce usage limits. Here is an example of how to pass your API key for authentication:

curl 'https://data.veridion.com/match/v4/companies' \
  -H "x-api-key: <your_api_key>" \
  -H "Content-type: application/json" \
  -d '{
    "legal_names": ["Sapiens International Corporation N.V."],
    "commercial_names": ["Sapiens"],
    "address_txt": "Holon, Israel"
  }'

If the API key is absent or the rate limits and quotas are exceeded, the API will respond with an error message, for example:

{
    "path": "/match/v4/companies",
    "status": 401,
    "error": "Unauthorized",
    "message": "Missing or invalid authorization key."
}