Back to API Docs

Authentication

The Invoice Navigator API uses API keys for authentication. Include your API key in the Authorization header of all requests.

API Keys

API keys are provided when you sign up for API access. Each key is tied to your account and has specific rate limits based on your plan.

Security: Keep your API key secret. Do not expose it in client-side code or public repositories.

Authentication Header

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -X POST https://api.invoicenavigator.eu/v1/validate \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"xml": "'"$(cat invoice.xml)"'"}'

Note: The API accepts JSON with the invoice XML content in the xml field. See the Validation API docs for the full request/response schema.

Key Prefixes

API keys have prefixes to indicate their type:

  • sk_live_ - Production key
  • sk_test_ - Test/sandbox key

Error Responses

If authentication fails, the API returns:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

Common Authentication Errors

StatusCodeDescription
401unauthorizedMissing or invalid API key
401key_revokedAPI key has been revoked
401key_expiredAPI key has expired
402quota_exceededMonthly API quota exceeded

Getting an API Key

API access is included with Business plan subscriptions. Get started instantly:

  1. Sign up for a Business plan
  2. Navigate to your Dashboard → API section
  3. Generate your API key instantly — no approval required

Enterprise customers: For custom rate limits or dedicated support, contact our team.