List Reminders API

https://api.incasso.io/v2/reminders

Met de List Reminders API kan je realtime informatie over een incassozaak ophalen.

Om een incassozaak op te halen heb je de unique identifier (uid) van de incassozaak nodig. Deze kan je vinden met de List Debtcollections API

Request

Bekijk alle incassozaken welke zijn aangemaakt binnen je administratie, gerangschikt van nieuw naar oud.

Parameters

limit het aantal incassozaken dat zullen worden weergegeven (met een maximum van 250).

Response

Resource Geeft aan dat het antwoord een reminder (betalingsherinnering) object bevat. De waarde zal bij deze api-call dan ook altijd reminder zijn.

Id De unieke id gekoppeld aan deze incassozaak. Deze unieke id wordt altijd automatisch gegenereerd bij het aanmaken van de incassozaak en start altijd met re_, bijvoorbeeld re_7UhSN1zuXS. Deze id wordt altijd gebruikt om te refereren naar een incassozaak.

Url De URL waarmee de incassozaak kan worden benaderd. Wil je het dossier rechtstreeks vanuit je administratie benaderen, zonder tussenkomst van een inlogscherm? Voeg dan de variabele apikey toe aan de url. Bijvoorbeeld:

https://portaal.incasso.io/re/{apikey}/c3097f04-6b98-4887-8d1f-6180356974b2

Status Statuscode van de incassozaak, bijvoorbeeld INIT SEND of PAID. Bekijk hier de verschillende statuscodes en de bijbehorende omschrijvingen.

ReminderTotal Het huidige saldo van de incassozaak.

Created De ingangsdatum van de incassozaak

Customer object Customer is een object met daarin een aantal essentiële debiteurgegevens.

Customer object

Customer Id De unieke id van de debiteur in jouw incasso.io administratie.

Customer Code Klantnummer van de debiteur uit jouw oorspronkelijke administratie.

Customer Name Volledige naam of bedrijfsnaam van debiteur

Request voorbeeld

cURL

curl -X GET https://api.incasso.io/v2/reminders \
   -H "Authorization: dHar4XY7LxsDOtmnkVtjNVWXLSlXsM" \

PHP

<?php
$incasso = new IncassoApi();
$incasso->setApiKey("dHar4XY7LxsDOtmnkVtjNVWXLSlXsM");
$listdebtcollections = $incasso->getdebtcollections();

ASP

<%
Set IncassoApi = New IncassoApiClient
IncassoApi.setApiKey("dHar4XY7LxsDOtmnkVtjNVWXLSlXsM")
Listdebtcollections = IncassoApi.GetDebtcollections()
%>

Response voorbeeld

HTTP/1.1 200 OK
Content-Type: application/hal+json

{
    "count": 4,
    "cases": [{
        "resource": "case",
        "id": "c3097f04-6b98-4887-8d1f-6180356974b2",
        "casenumber":"20100315",
        "url":"https://app.incasso.io/re/re_WDqYK6vllg",
        "status":"SOM1",
        "saldo":"551.40",
        "ingangsdatum":"30-10-2020",
        "customer": {
            "Id": "ec9fed02-3c52-41ec-93dd-bad2f4d5b965",
            "Code": "1001",
            "name": "Test B.V."
            }
        },
        { },
        { },
        { }
        ]
}