Developer API

Build your own histamine-intolerance app on our catalog and recipes. Create an API client, accept the agreement, and start calling the read-only v1 API.

API Agreement (v1-2026)

This API provides read-only access to our histamine catalog and recipes so you can build your own applications (for example a native app) for people with histamine intolerance.

1. Medical disclaimer — The data is informational only and is not a substitute for professional medical or dietetic advice. Your application must show a comparable disclaimer to its users.

2. Attribution — Applications using this API must credit "The Histamine Food list / Histamine & Voeding" as the data source, with a link where practical.

3. Fair use — Respect the published rate limits. Do not scrape, bulk-redistribute, or resell the raw dataset. Caching for your own application’s performance is allowed.

4. Credentials — Keep your client secret confidential. You are responsible for all usage under your credentials. Rotate the secret immediately if you suspect it leaked.

5. Availability & changes — The API is provided as-is, without uptime guarantees. We may change or deprecate endpoints; breaking changes will be introduced under a new version prefix where reasonably possible.

6. Termination — We may revoke credentials that violate this agreement or that put the service at risk.

By accepting, you confirm you have read and agree to these terms. Your acceptance (version and timestamp) is recorded with your account.

Quick start

Full interactive documentation of every endpoint — try calls directly from your browser with your token:

Open API documentation ↗

# 1. Exchange your credentials for a 1h access token
curl -X POST https://api.histaminevoeding.nl/v1/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"clientId":"hfl_...","clientSecret":"hfls_..."}'

# 2. Call the read-only v1 API with the token
curl 'https://api.histaminevoeding.nl/v1/products?lang=en' \
  -H 'Authorization: Bearer <access_token>'