Aan de slag

1. Maak een account aan

Ga naar /register en vul uw e-mailadres, naam en optioneel een Tsjechisch bedrijfs-ID (IČO) in. Als u een IČO opgeeft, worden de bedrijfsnaam, het btw-nummer en het adres automatisch ingevuld vanuit het ARES-register.

Voer nog geen wachtwoord in — u stelt dit in de volgende stap in nadat u op de verificatielink hebt geklikt.

2. Verifieer het e-mailadres en stel een wachtwoord in

Binnen enkele seconden ontvangt u een e-mail met een verificatielink. Klik erop. U komt op een pagina terecht waar u uw wachtwoord instelt (min. 8 tekens).

Zodra het wachtwoord is ingesteld, bent u ingelogd en kunt u direct naar het dashboard gaan.

3. Maak uw eerste aanbestedingsfilter aan

Klik in het dashboard op Aanbestedingen → Nieuw filter. Een filter is een opgeslagen set criteria die het systeem gebruikt om u overeenkomende aanbestedingen te sturen:

1. Regio — regio of meerdere regio's (Praag, Midden-Bohemen, …)
2. Sector — aanbestedingscategorie (Gebouwen, IT-ontwikkeling, …) of CPV-code
3. Trefwoorden — woorden die in de titel of omschrijving moeten voorkomen (bijv. "brugrestauratie")
4. Waarde — minimale/maximale verwachte aanbestedingswaarde

Een gedetailleerde beschrijving van alle filterparameters vindt u in de Lead Watcher-documentatie.

4. Schakel de e-maildigest in

Elk filter kan een dagelijkse e-maildigest hebben. Elke dag om 7:00 ontvangt u een e-mail met aanbestedingen die die dag zijn toegevoegd en overeenkomen met uw filter.

De digest wordt in- of uitgeschakeld via de filterdetails — de schakelaar "E-maildigest" bovenaan. U kunt meerdere filters hebben, elk met een eigen digest-instelling.

Hello world

Met een sleutel ziet de aanroep er als volgt uit:

curl -H "X-Api-Key: mrw_live_…" \
  "https://veritra.io/api/v2/leads/tenders/search?qText=bridge%20reconstruction&limit=5"

Geeft JSON terug met de meest recente openstaande aanbestedingen. Volledige zoekparameters vindt u in de Lead Watcher-documentatie.

Hoe u een sleutel verkrijgt

Uw eerste API-sleutel wordt aangemaakt via het dashboard: registreer u op de website, verifieer uw e-mailadres en klik vervolgens in Instellingen → Integraties op "Sleutel genereren". De sleutel wordt eenmalig getoond — sla hem onmiddellijk op (bijv. in env / secrets store). Als u hem kwijtraakt, maak dan een nieuwe aan en verwijder de oude.

De sleutel gebruiken met MCP-clients (Claude Desktop, Cursor, …)

De sleutel is hetzelfde als voor de REST API. Alleen de manier waarop de client hem verzendt verschilt: de MCP-server draait op /api/mcp en de sleutel wordt meegegeven in de X-Api-Key-handshake-header. De volledige configuratie voor Claude Desktop, Cursor en generieke HTTP-clients vindt u in de MCP-documentatie.

Authenticatie

Alle /api/v2-eindpunten authenticeren met één API-sleutel (formaat mrw_live_HEX64). De sleutel kan worden meegestuurd als X-Api-Key-header of als Bearer-token:

# header X-Api-Key
curl -H "X-Api-Key: mrw_live_…" https://veritra.io/api/v2/account/me

# nebo Bearer (kompatibilní s OpenAPI client generators)
curl -H "Authorization: Bearer mrw_live_…" https://veritra.io/api/v2/account/me

De sleutel bevat de gebruikersidentiteit. Welke services ermee kunnen worden aangeroepen, wordt bepaald door het abonnement (zie de sectie Abonnementen). U kunt maximaal 5 actieve sleutels hebben — handig om prod / dev / per systeem te scheiden.

Respons-envelop

Alle v2-eindpunten retourneren een uniforme JSON-envelop. Enkele resource onder data, gepagineerde lijsten onder data + pagination, fouten onder error.

Geslaagd

// Enkele resource
{ "data": { "id": "…", "field": "…" } }

// Gepagineerde lijst
{
  "data": [{ "…": "…" }],
  "pagination": { "nextCursor": "abc123…", "totalCount": 42 }
}

Fout

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Field 'url' must be a valid HTTPS URL.",
    "details": { "field": "url" }
  }
}

Stabiele foutcodes: UNAUTHORIZED, FORBIDDEN, NOT_FOUND, VALIDATION_ERROR, CONFLICT, RATE_LIMITED, ENTITLEMENT_REQUIRED, INTERNAL. Clients dienen te vertakken op code, niet op message — de HTTP-statuscode wordt automatisch aan code gekoppeld.

Snelheidslimieten

Bij overschrijding retourneert de API HTTP 429 met een Retry-After header (seconden).

Proefperiode en facturering

Na het aanmaken van een account ontvangt u een gratis proefperiode van 7 dagen van Lead Watcher — geen creditcard of factureringsprofiel vereist. Daarna heeft u een creditcard of een betaalde proforma-factuur nodig, anders wordt de service SUSPENDED en retourneren verdere aanroepen 403. Geen tierbundels — betaal per service, op elk moment opzegbaar.

Account-API

Beheer account, sleutels, facturering en webhooks. Alle /api/v2/account/*-eindpunten vereisen sleutelauthenticatie.

Equivalent aan /profile + /subscriptions + apiKey-info. Handig voor de initiële laadbeurt in UI-clients.

{
  "data": {
    "account": { "email": "…", "name": "…", "company": "…", "ico": "…", "country": "CZ", "locale": "cs", "isComplete": true },
    "subscriptions": [
      { "service": "LEADS", "scope": "CZ", "state": "ACTIVE", "tier": "PAID", "trialEndsAt": null, "paidUntil": "2026-06-30T22:00:00.000Z", "cancelAtPeriodEnd": false }
    ],
    "apiKey": { "keyPrefix": "mrw_live_7fa7785c", "lastUsedAt": "…", "requestsMonth": 120, "requestsLimit": 500 }
  }
}

Wachtwoord en sessie

API-sleutels

De sleutel authenticeert tegen de volledige API. U kunt maximaal 5 actieve sleutels hebben. De onbewerkte sleutel wordt alleen geretourneerd bij aanmaak of rotatie — daarna alleen opvraagbaar door een nieuwe aan te maken.

{ "label": "Production ERP" }

{
  "data": {
    "id": "cm…",
    "key": "mrw_live_<hex64>",
    "keyPrefix": "mrw_live_7fa7785c",
    "label": "Production ERP",
    "createdAt": "…"
  }
}

De sleutel in de respons is hier alleen in zijn geheel beschikbaar. De server slaat alleen de SHA-256-hash op; de onbewerkte sleutel kan later niet worden opgehaald. Indien verloren, maak een nieuwe aan en verwijder de oude.

Serviceabonnementen

Proefactivering, statusoverzicht, geplande annulering op paidUntil/trialEndsAt. Gebruik /billing/checkout voor activering met betaalkaart.

{ "service": "LEADS", "scope": "CZ", "mode": "trial" }

{ "service": "LEADS", "scopes": ["CZ","SK","DE"], "mode": "trial" }

{ "cancelAtPeriodEnd": true }

API-gebruik

Dagelijks aggregaat van API-sleuteloproepen voor de afgelopen N dagen (standaard 30). Voor bewaking van het verbruik van de snelheidslimiet.

Facturering

{ "cycle": "MONTHLY", "currency": "CZK", "scopes": ["CZ","SK"] }

Gegevensexport (AVG)

Accountopzegging

{ "action": "DEACTIVATE" }

Webhooks

Webhooks op accountniveau — één eindpunt dekt alle filters en toekomstige services. Elke gebeurtenis bevat een HMAC-SHA256-handtekening in X-Signature-256, een idempotentiesleutel in X-Idempotency-Key en het type in X-Event-Type. Opnieuw proberen met exponentiële terugval tot ~33 uur.

Max. 5 eindpunten per account. Ondersteunde gebeurtenissen en payload-schema's zijn per service gedocumenteerd.

{
  "url": "https://yourapp.cz/api/veritra-webhook",
  "enabledEvents": ["leads.match.created"],
  "description": "production"
}

Meldingen

Feedback

OpenAPI 3.1-specificatie

De volledige machine-leesbare API-specificatie is beschikbaar op /openapi.json. Gebruik deze om getypeerde clients te genereren in elke gewenste taal (TypeScript, Python, Go, Rust, …) of om te importeren in Postman / Insomnia / Swagger UI.

# Generate TypeScript client
npx openapi-typescript https://veritra.io/openapi.json -o ./veritra-types.ts

# Generate Python client (openapi-python-client)
openapi-python-client generate --url https://veritra.io/openapi.json

Foutcodes