Développeurs

Un appel. Le document officiel.

Govreader repose sur l’API de Wealthreader : HTTPS, paramètres de formulaire et réponse JSON. Si vous intégrez déjà Wealthreader, vous savez déjà intégrer Govreader.

  1. Lancez la requête

    Envoyez votre clé d’API et le code du document. La réponse contient la session et le code QR que le titulaire doit approuver avec Cl@ve.

    curl https://api.wealthreader.com/entities/ \
      -d api_key=$API_KEY \
      -d code=declaracion_renta
  2. Le titulaire approuve

    Votre client scanne le code avec l’application Cl@ve et confirme. Vous rappelez ensuite l’API avec la session pour récupérer le résultat.

    curl https://api.wealthreader.com/entities/ \
      -d api_key=$API_KEY \
      -d code=declaracion_renta \
      -d session=$SESSION \
      -d otp=PUSH
  3. Recevez la réponse

    Données normalisées et document d’origine encodé en Base64, prêts pour votre dossier.

    Exemple avec la déclaration de revenus. Les valeurs sont illustratives.

    {
      "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…"
          }
        ]
      }
    }

Conçue pour la production

Un même contrat

Les mêmes paramètres et la même structure de réponse pour tous les organismes.

Des erreurs explicites

Des codes documentés qui distinguent un accès non approuvé, un organisme en maintenance ou un rapport émis en différé.

Rapports en différé

Certains organismes, comme le Banco de España, ne remettent pas le rapport instantanément. L’API vous le signale et vous le récupérez lorsqu’il est prêt.

Documentation publique

Référence complète de l’API, avec les schémas de réponse et les codes d’erreur.

Découvrez Govreader avec les documents de votre secteur

Nous vous présentons le parcours complet — identification, requête et réponse — sur les cas qui vous intéressent le plus.

Demander une démo