GET
/api/v1/jortt/loonjournaalposten Opmerkingen
-
Authenticeer met je API-sleutel in de header
Authorization: Bearer apib_live_JOUW_SLEUTEL. - Het antwoord is gepagineerd: herhaal de aanvraag met
?cursor=<next_cursor>totnext_cursornullis. - Deze tabel ondersteunt incrementeel ophalen met
modified_since. - Rijen die bij de bron zijn verwijderd blijven bestaan met een gevulde
bron_verwijderd_op. Standaard worden ze niet getoond, metinclude_deleted=truewel.
Queryparameters
| Parameter | Omschrijving |
|---|---|
connection | Beperk tot één gekoppeld account (UUID uit connections). |
limit | Aantal rijen per pagina, 1 t/m 1000 (standaard 100). |
cursor | De waarde van next_cursor uit het vorige antwoord (24 uur geldig). |
modified_since | Alleen rijen die sinds dit tijdstip zijn gewijzigd (ISO 8601), inclusief verwijderde rijen. |
include_deleted | true = ook rijen die bij de bron zijn verwijderd (bron_verwijderd_op is dan gevuld). |
Filteren kan op elk veld hieronder: schrijf veld=waarde (gelijk aan) of veld[operator]=waarde,
bijvoorbeeld id[ne]=waarde. De operatoren die per veld beschikbaar zijn staan in de
OpenAPI-specificatie.
Velden
| Veld | Type | Omschrijving |
|---|---|---|
connection_id | uuid | Account (connection) |
connection_label | text | Accountnaam |
id | uuid | ID |
synced_at | timestamptz | Laatst gesynchroniseerd |
bron_verwijderd_op | timestamptz | Verwijderd bij de bron |
external_id | text | Bron-ID |
periode | date | Periode |
bruto_loon | numeric | Bruto loon |
werkgeversdeel_sociale_lasten | numeric | Werkgeversdeel sociale lasten |
werkgeversdeel_pensioenkosten | numeric | Werkgeversdeel pensioenkosten |
reservering_vakantiegeld | numeric | Reservering vakantiegeld |
reservering_eindejaarsuitkering | numeric | Reservering eindejaarsuitkering |
onbelaste_reiskostenvergoedingen | numeric | Onbelaste reiskostenvergoedingen |
onbelaste_vergoedingen_gericht_vrijgesteld | numeric | Onbelaste vergoedingen (gericht vrijgesteld) |
onbelaste_vergoedingen_wkr | numeric | Onbelaste vergoedingen (WKR) |
declaraties_algemeen | numeric | Declaraties algemeen |
declaraties_kantoorkosten | numeric | Declaraties kantoorkosten |
declaraties_lunch_en_diner_representatiekosten | numeric | Declaraties lunch, diner en representatie |
declaraties_reiskosten | numeric | Declaraties reiskosten |
declaraties_auto_en_transportkosten | numeric | Declaraties auto en transport |
declaraties_verkoopkosten | numeric | Declaraties verkoopkosten |
eindheffing_wkr | numeric | Eindheffing WKR |
netto_inhoudingen | numeric | Netto inhoudingen |
afdrachtvermindering_speur_en_ontwikkelingswerk | numeric | Afdrachtvermindering S&O |
te_betalen_nettolonen | numeric | Te betalen nettolonen |
te_betalen_sociale_lasten_loonbelasting | numeric | Te betalen sociale lasten en loonbelasting |
te_betalen_pensioenpremies | numeric | Te betalen pensioenpremies |
te_betalen_vakantiegeld | numeric | Te betalen vakantiegeld |
te_betalen_eindejaarsuitkering | numeric | Te betalen eindejaarsuitkering |
te_betalen_loonbeslag | numeric | Te betalen loonbeslag |
Importeren in je tools
Aanvraag
GET https://app.apiboard.nl/api/v1/jortt/loonjournaalposten?modified_since=2026-01-01T00%3A00%3A00Z HTTP/1.1
Host: app.apiboard.nl
Authorization: Bearer apib_live_JOUW_SLEUTEL
# Let op: gepagineerd. Herhaal met &cursor=<next_cursor> tot next_cursor null is.
# Deze aanroep haalt alleen rijen op die sinds die datum zijn gewijzigd (ook verwijderde,
# met bron_verwijderd_op). De laatste pagina bevat sync_watermark: geef die bij de volgende
# run mee als modified_since om daarna alleen nieuwe wijzigingen op te halen. curl -H "Authorization: Bearer apib_live_JOUW_SLEUTEL" \
"https://app.apiboard.nl/api/v1/jortt/loonjournaalposten?modified_since=2026-01-01T00%3A00%3A00Z"
# Let op: gepagineerd. Herhaal met &cursor=<next_cursor> tot next_cursor null is.
# Deze aanroep haalt alleen rijen op die sinds die datum zijn gewijzigd (ook verwijderde,
# met bron_verwijderd_op). De laatste pagina bevat sync_watermark: geef die bij de volgende
# run mee als modified_since om daarna alleen nieuwe wijzigingen op te halen. import json
import os
import requests
TOKEN = "apib_live_JOUW_SLEUTEL"
URL = "https://app.apiboard.nl/api/v1/jortt/loonjournaalposten"
STAAT_BESTAND = "jortt_loonjournaalposten_staat.json" # bewaart rijen + watermark tussen runs
staat = {"watermark": None, "rijen": {}}
if os.path.exists(STAAT_BESTAND):
with open(STAAT_BESTAND) as f:
staat = json.load(f)
basis_params = {}
# Alleen wijzigingen: de eerste run vanaf 2026-01-01, daarna telkens vanaf de vorige run
# (inclusief verwijderingen, die hieronder uit de lokale set gaan).
basis_params["modified_since"] = staat["watermark"] or "2026-01-01T00:00:00Z"
cursor = None
onvolledig = set()
while True:
params = dict(basis_params)
if cursor:
params["cursor"] = cursor
resp = requests.get(URL, params=params, headers={"Authorization": f"Bearer {TOKEN}"})
resp.raise_for_status()
body = resp.json()
for koppeling in body["connections"]:
if not koppeling["backfill_complete"]:
onvolledig.add(koppeling["label"])
for rij in body["data"]:
staat["rijen"][rij["id"]] = rij # dedupliceren op id, laatste versie wint
cursor = body["next_cursor"]
if cursor is None:
staat["watermark"] = body["sync_watermark"]
break
# Rijen die bij de bron verwijderd zijn, uit de lokale set halen.
staat["rijen"] = {i: r for i, r in staat["rijen"].items() if not r.get("bron_verwijderd_op")}
with open(STAAT_BESTAND, "w") as f:
json.dump(staat, f)
for label in sorted(onvolledig):
print(f"Waarschuwing: {label} is nog niet volledig gesynchroniseerd; de data kan onvolledig zijn.")
print(f"{len(staat['rijen'])} rijen.")
# Tip: verwijder af en toe (bv. maandelijks) jortt_loonjournaalposten_staat.json voor een volledige run; een
# hele koppeling die is losgekoppeld, zie je incrementeel namelijk niet. let
Basis = "https://app.apiboard.nl",
Pad = "/api/v1/jortt/loonjournaalposten",
Token = "apib_live_JOUW_SLEUTEL",
Filters = [modified_since = "2026-01-01T00:00:00Z"],
HaalPaginaOp = (cursor as nullable text) =>
Json.Document(Web.Contents(Basis, [
RelativePath = Pad,
Query = if cursor = null then Filters else Record.AddField(Filters, "cursor", cursor),
Headers = [Authorization = "Bearer " & Token]
])),
// Volg next_cursor tot die null is; de pagina met next_cursor = null telt ook mee.
Paginas = List.Generate(
() => HaalPaginaOp(null),
each _ <> null,
each if [next_cursor] = null then null else HaalPaginaOp([next_cursor]),
each [data]
),
AlleRijen = List.Combine(Paginas),
Tabel = if List.IsEmpty(AlleRijen)
then #table({"id", "synced_at"}, {})
else Table.FromRecords(AlleRijen, null, MissingField.UseNull),
// Dedupliceer op id (een rij die tijdens de refresh wijzigt, kan twee keer terugkomen):
// eerst de nieuwste versie bovenaan, dan houdt Distinct die. Verwijder daarna rijen
// die bij de bron verwijderd zijn.
NieuwsteEerst = Table.Buffer(Table.Sort(Tabel, {{"synced_at", Order.Descending}})),
ZonderDubbel = Table.Distinct(NieuwsteEerst, {"id"}),
ZonderVerwijderd = Table.SelectRows(ZonderDubbel, each Record.FieldOrDefault(_, "bron_verwijderd_op", null) = null)
in
ZonderVerwijderd
// Let op: het token staat hierboven in de M-query, en dus in het .pbix-bestand zelf -
// wees voorzichtig met het delen van dat bestand.
// Let op: staat een administratie in "connections" op backfill_complete = false, dan is
// die nog niet volledig gesynchroniseerd - de data hierboven kan dan onvolledig zijn.
// Let op: Power BI onthoudt geen stand tussen refreshes. Deze query haalt bij elke refresh
// de rijen op die sinds 2026-01-01 zijn gewijzigd, niet de hele tabel. Voorbeeldantwoord
{
"connections": [
{
"id": "43d9a41a-3529-4be2-b891-b23781997895",
"label": "Voorbeeld B.V.",
"backfill_complete": true
}
],
"data": [
{
"connection_id": "43d9a41a-3529-4be2-b891-b23781997895",
"connection_label": "Voorbeeld B.V.",
"id": "314feb6e-f809-4f72-b6d8-da1b68d15ab5",
"synced_at": "2026-10-07T02:58:12.304211+00:00",
"bron_verwijderd_op": null,
"external_id": "voorbeeld external_id",
"periode": "2026-01-15",
"bruto_loon": 125.5,
"werkgeversdeel_sociale_lasten": 125.5,
"werkgeversdeel_pensioenkosten": 125.5,
"reservering_vakantiegeld": 125.5,
"reservering_eindejaarsuitkering": 125.5,
"onbelaste_reiskostenvergoedingen": 125.5,
"onbelaste_vergoedingen_gericht_vrijgesteld": 125.5,
"onbelaste_vergoedingen_wkr": 125.5,
"declaraties_algemeen": 125.5,
"declaraties_kantoorkosten": 125.5,
"declaraties_lunch_en_diner_representatiekosten": 125.5,
"declaraties_reiskosten": 125.5,
"declaraties_auto_en_transportkosten": 125.5,
"declaraties_verkoopkosten": 125.5,
"eindheffing_wkr": 125.5,
"netto_inhoudingen": 125.5,
"afdrachtvermindering_speur_en_ontwikkelingswerk": 125.5,
"te_betalen_nettolonen": 125.5,
"te_betalen_sociale_lasten_loonbelasting": 125.5,
"te_betalen_pensioenpremies": 125.5,
"te_betalen_vakantiegeld": 125.5,
"te_betalen_eindejaarsuitkering": 125.5,
"te_betalen_loonbeslag": 125.5
}
],
"next_cursor": null,
"sync_watermark": "2026-10-07T03:00:00.000000Z"
} De waarden zijn fictief; de vorm komt overeen met wat de API teruggeeft.
Velden in het antwoord
connections-
De gekoppelde accounts waar dit antwoord over gaat. Elk account heeft een
id, eenlabelenbackfill_complete:truebetekent dat de eerste volledige synchronisatie klaar is,falsedat de data nog onvolledig is. data-
De rijen. Elke rij heeft
connection_idenconnection_label: uit welk account de rij komt. next_cursor- Waarmee je de volgende pagina ophaalt.
nullbetekent dat je bij de laatste pagina bent. sync_watermark-
Tot dit tijdstip is de data compleet. Gebruik het als startpunt (
modified_since) voor de volgende incrementele ophaalronde.