Ontwikkelaars

Eén aanroep. Het officiële document.

Govreader draait op de API van Wealthreader: HTTPS, formulierparameters en JSON-antwoord. Wie Wealthreader al integreert, weet ook hoe Govreader werkt.

Start de aanvraag

Stuur uw API-sleutel en de code van het document. Het antwoord bevat de sessie en de QR-code die de betrokkene met Cl@ve moet goedkeuren.
Aanvraag
```
curl https://api.wealthreader.com/entities/ \
  -d api_key=$API_KEY \
  -d code=declaracion_renta
```
De betrokkene keurt goed

Uw klant scant de code met de Cl@ve-app en bevestigt. U herhaalt de aanroep met de sessie om het resultaat op te halen.
Na goedkeuring
```
curl https://api.wealthreader.com/entities/ \
  -d api_key=$API_KEY \
  -d code=declaracion_renta \
  -d session=$SESSION \
  -d otp=PUSH
```

Ontvang het antwoord

Genormaliseerde data en het originele document als Base64, klaar voor uw dossier.

Voorbeeld met de belastingaangifte. De waarden zijn illustratief.

{
  "success": true,
  "payload": {
    "tax_returns": [
      {
        "model": "100",
        "fiscal_year": 2025,
        "filing_date": "2026-05-14",
        "filing_type": "individual",
        "result_amount": -1284.36,
        "secure_verification_code": "QJ7M4KXT9PLD2WHV",
        "xml_file": "PD94bWwgdmVyc2lvbj0i…",
        "pdf_file": "JVBERi0xLjcK…"
      }
    ]
  }
}

Gebouwd voor productie

Eén contract

Dezelfde parameters en dezelfde antwoordstructuur voor alle instanties.

Foutmeldingen met betekenis

Gedocumenteerde codes die onderscheid maken tussen een niet-goedgekeurde toegang, een instantie in onderhoud of een rapport dat met vertraging wordt geleverd.

Rapporten met vertraging

Sommige instanties, zoals het Banco de España, leveren het rapport niet direct. De API meldt dit en u haalt het op zodra het klaar is.

Openbare documentatie

Volledige API-referentie, met de antwoordschema’s en de foutcodes.

Open de API-referentie (opent in een nieuw tabblad) Toegang aanvragen

Zie Govreader met de documenten uit uw sector

Wij tonen de volledige stroom — identificatie, aanvraag en antwoord — met de toepassingen die u het meest interesseren.

Demo aanvragen