Aralda API

Read tenders, deadlines, filters and sources from your tools using the API.

Authentication

https://api.aralda.com/v1

Authorization: Bearer arla_…

The full key is shown only once. Copy it and keep it safe: do not share it.

Plan	Requests per day	Requests per minute	Results per page	Maximum offset
Hunter	200	30	25	500
Guild	20,000	120	100	10,000
Master	2,000	30	50	2,500

Search tenders by keywords, country, CPV, buyer and 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_…'

Tender details by ID.

Parameters: id (UUID)

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

Open tenders ordered by 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_…'

List your saved filters.

Parameters: —

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

New tenders for your filter; the first call covers the last 7 days, then updates the last-seen time.

Parameters: id (UUID)

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

List of active sources and their licence.

Parameters: —

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

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

401 auth — Key missing or invalid.
402 abbonamento — Subscription inactive or expired.
403 accesso — Your plan does not include API access.
429 quota — Request limit reached; retry after the indicated interval. · Retry-After
400 invalid_input — Invalid parameters.
404 not_found — Resource not found.