Aralda-API

Bekijk aanbestedingen, deadlines, filters en bronnen vanuit je tools via de API.

Authenticatie

https://api.aralda.com/v1

Authorization: Bearer arla_…

De volledige sleutel wordt maar één keer getoond. Kopieer hem en bewaar hem veilig: deel hem niet.

Abonnement	Verzoeken per dag	Verzoeken per minuut	Resultaten per pagina	Maximale offset
Jager	200	30	25	500
Gilde	20.000	120	100	10.000
Meester	2.000	30	50	2.500

Zoek aanbestedingen op trefwoorden, land, CPV, opdrachtgever en deadline.

Parameters: q, paese (ISO2, CSV ≤10), cpv ([0-9]{1,8}, CSV ≤10), ente, scadenza_giorni (1–365), pagina, per_page

curl 'https://api.aralda.com/v1/search?q=software&paese=IT&pagina=1&per_page=10' \
  -H 'Authorization: Bearer arla_…'

Details van een aanbesteding via de ID.

Parameters: id (UUID)

curl 'https://api.aralda.com/v1/tenders/00000000-0000-4000-8000-000000000001' \
  -H 'Authorization: Bearer arla_…'

Open aanbestedingen gesorteerd op deadline.

Parameters: giorni (1–365), limite (1–200, ≤ per_page), pagina, per_page

curl 'https://api.aralda.com/v1/deadlines?giorni=30&limite=10&per_page=10' \
  -H 'Authorization: Bearer arla_…'

Lijst van je opgeslagen filters.

Parameters: —

curl 'https://api.aralda.com/v1/filters' \
  -H 'Authorization: Bearer arla_…'

Nieuwe aanbestedingen voor je filter; de eerste aanroep omvat de laatste 7 dagen en werkt daarna de laatst bekeken tijd bij.

Parameters: id (UUID)

curl 'https://api.aralda.com/v1/filters/00000000-0000-4000-8000-000000000002/new' \
  -H 'Authorization: Bearer arla_…'

Lijst van actieve bronnen en hun licentie.

Parameters: —

curl 'https://api.aralda.com/v1/sources' \
  -H 'Authorization: Bearer arla_…'

{"ok":false,"family":"auth","correlation_id":"…"}

401 auth — Sleutel ontbreekt of is ongeldig.
402 abbonamento — Abonnement inactief of verlopen.
403 accesso — Je abonnement bevat geen API-toegang.
429 quota — Verzoeklimiet bereikt; probeer het na de aangegeven tijd opnieuw. · Retry-After
400 invalid_input — Ongeldige parameters.
404 not_found — Bron niet gevonden.