Kom i gang
API'et er en del af Talverk-portalen. En virksomhed får en nøgle, når den har en bogholder med et abonnement på portalen, og bogholderen har slået API'et til for den. Nøglen oprettes i kundeportalen under Virksomhed → Apps → API og giver kun adgang til den ene virksomhed - og kun til det, bogholderen deler med den.
- Prøv API'et med sandkasse-nøglen herunder - den giver kun opdigtede tal fra demoen.
- Byg jeres integration med en testnøgle (
tvk_test_) - den giver også kun demoens tal.
- Skift til en live-nøgle (
tvk_live_), når bogholderen har slået det til.
Sandkassen
Offentlig nøgle - kun læsning af demoens opdigtede tal, med egne grænser pr. IP-adresse:
curl https://talverk.dk/portal/api/v1/virksomhed/ \
-H "Authorization: Bearer tvk_test_sandkasse_offentlig"
Vilkårene for API'et følger, før API'et åbnes for rigtige data. Sandkassen og testnøglerne viser kun opdigtede tal.
Godkendelse
Send nøglen i Authorization-hovedet - kun over https:
Authorization: Bearer tvk_live_...
En nøgle i adressen (fx ?key=) afvises og tilbagekaldes med det samme, så I skal lave en ny. Send aldrig nøglen over http - API'et svarer kun over https. Kald API'et fra jeres server, ikke fra en browser (der er ingen CORS). Adressen er jeres bogholders portaladresse, fx https://talverk.dk/portal/api/v1/.
tvk_live_... - virksomhedens egne tal.
tvk_test_... og sandkassen - kun demoens opdigtede tal. Hvilke data en nøgle giver, afgøres af nøglen selv - aldrig af en parameter.
Endpoints
Alle svar er JSON. Beløb er tekst med to decimaler ("1234.50"), datoer ÅÅÅÅ-MM-DD. Læse-endpointene svarer i et omslag: virksomhed, tilstand (live eller test), hentet (hvornår tallene sidst blev hentet fra regnskabsprogrammet), fortegn, data og naeste. Fortegn: konti/ og posteringer/ har bogføringens (debet +, kredit -), resten opstillingens (indtægter, egenkapital og gæld med plus).
GET/portal/api/v1/virksomhed/
Virksomheden
Navn, CVR-nummer, regnskabsprogram, regnskabsårene med perioderne - og nøglens adgang.
Alle nøgler.
Eksempel på svar (opdigtede tal)
{
"navn": "Nordlys Design ApS",
"cvr": "41234567",
"regnskabsprogram": "e-conomic",
"regnskabsaar": [
{
"id": "2026",
"navn": "2026",
"fra": "2026-01-01",
"til": "2026-12-31",
"perioder": [
{
"nr": 1,
"fra": "2026-01-01",
"til": "2026-01-31"
}
]
}
],
"noeglens_adgang": [
"regnskab:laes"
],
"delt_med_virksomheden": [
"fakturaer:laes",
"regnskab:laes"
]
}
Fejl: 401 mangler_noegle, 401 ukendt_noegle, 429 for_mange_kald
GET/portal/api/v1/konti/
Konti med saldi
Kontoplanen, som kunden ser den under Regnskab: årets bevægelse, sidste år og saldoen. Bogføringens fortegn (debet +, kredit -).
Adgang: regnskab:laes
| Parameter | Type | Beskrivelse |
aar | string | Regnskabsårets id fra virksomhed/ (standard: indeværende år). |
fra_periode | integer | Første periode (1-18) - sammen med til_periode. |
til_periode | integer | Sidste periode (1-18) - sammen med fra_periode. |
Eksempel på svar (opdigtede tal)
{
"aar": "2026",
"konti": [
{
"nr": "1010",
"navn": "Salg af ydelser",
"slags": "resultat",
"i_aar": "-842500.00",
"sidste_aar": "-790000.00",
"saldo": null
}
]
}
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet
GET/portal/api/v1/posteringer/
Posteringer på en konto
Bogførte posteringer og kladdens posteringer på én konto fra portalens seneste hentning. Bogføringens fortegn. Delt i sider.
Adgang: regnskab:laes · Delt i sider.
| Parameter | Type | Beskrivelse |
aar | string | Regnskabsårets id fra virksomhed/ (standard: indeværende år). |
konto (påkrævet) | string | Kontonummeret (påkrævet). |
fra_dato | string | Fra og med datoen (ÅÅÅÅ-MM-DD). |
til_dato | string | Til og med datoen (ÅÅÅÅ-MM-DD). |
antal | integer | Rækker pr. side (1-500, standard 100). |
efter | string | Markøren fra "naeste" i forrige svar. |
Eksempel på svar (opdigtede tal)
[
{
"dato": "2026-03-14",
"konto": "1010",
"bilag": 1043,
"tekst": "Faktura 1043",
"beloeb": "-12500.00",
"kladde": false
}
]
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 400 ugyldig_markoer, 409 markoer_udloebet, 404 ikke_fundet
GET/portal/api/v1/resultatopgoerelse/
Resultatopgørelse
Som kundens side Regnskab -> Resultat med mellemresultaterne. Indtægter med plus og udgifter med minus.
Adgang: regnskab:laes
| Parameter | Type | Beskrivelse |
aar | string | Regnskabsårets id fra virksomhed/ (standard: indeværende år). |
fra_periode | integer | Første periode (1-18) - sammen med til_periode. |
til_periode | integer | Sidste periode (1-18) - sammen med fra_periode. |
Eksempel på svar (opdigtede tal)
{
"aar": "2026",
"periode": "2026",
"linjer": [
{
"slags": "konto",
"nr": "1010",
"navn": "Salg af ydelser",
"i_aar": "842500.00",
"sidste_aar": "790000.00"
}
]
}
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet
GET/portal/api/v1/balance/
Balance
Aktiver og passiver som på kundens side Regnskab. Egenkapital og gæld med plus.
Adgang: regnskab:laes
| Parameter | Type | Beskrivelse |
aar | string | Regnskabsårets id fra virksomhed/ (standard: indeværende år). |
fra_periode | integer | Første periode (1-18) - sammen med til_periode. |
til_periode | integer | Sidste periode (1-18) - sammen med fra_periode. |
Eksempel på svar (opdigtede tal)
{
"aar": "2026",
"periode": "2026",
"aktiver": [
{
"slags": "konto",
"nr": "5810",
"navn": "Bank",
"i_aar": "15000.00",
"sidste_aar": "0.00",
"saldo": "215000.00"
}
],
"passiver": [],
"forskel": null
}
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet
GET/portal/api/v1/debitorer/
Debitorer (åbne poster)
Som kundens side Debitorer -> Skylder nu. Beløbene i kroner - en faktura i fremmed valuta har også valutaen og beløbet i valutaen.
Adgang: debitorer:laes
| Parameter | Type | Beskrivelse |
vis | string: skyldes, alle | "skyldes" (standard) eller "alle" åbne poster. |
Eksempel på svar (opdigtede tal)
{
"visning": "skyldes",
"kunder": [
{
"kundenr": "101",
"navn": "Kunde A/S",
"saldo": "25000.00",
"forfaldent": "0.00",
"fakturaer": [
{
"nr": "1043",
"dato": "2026-10-01",
"forfald": "2026-10-15",
"beloeb": "25000.00",
"mangler": "25000.00",
"dage_over_forfald": 0
}
]
}
],
"i_jeres_favoer": []
}
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet
GET/portal/api/v1/kreditorer/
Kreditorer (åbne poster)
De åbne leverandørfakturaer pr. hentningens dag - som den automatiske kreditorsaldoliste.
Adgang: kreditorer:laes
Eksempel på svar (opdigtede tal)
{
"pr_dato": "2026-10-14",
"leverandoerer": [
{
"nr": "201",
"navn": "Leverandør ApS",
"i_alt": "4375.00",
"fakturaer": [
{
"nr": "F-88",
"forfald": "2026-10-20",
"dage_over_forfald": 0,
"beloeb": "4375.00"
}
]
}
],
"kreditorkort_afviger": []
}
Fejl: 403 scope_mangler, 403 ikke_delt, 409 ikke_hentet
GET/portal/api/v1/fakturaer/
Fakturaer fra bogholderiet
Fakturaerne fra bogholderiet til virksomheden (som under Fakturaer). Ingen PDF og ingen timer.
Adgang: fakturaer:laes · Delt i sider.
| Parameter | Type | Beskrivelse |
fra_dato | string | Fra og med datoen (ÅÅÅÅ-MM-DD). |
til_dato | string | Til og med datoen (ÅÅÅÅ-MM-DD). |
betalt | string: ja, nej | Kun betalte eller ubetalte. |
antal | integer | Rækker pr. side (1-500, standard 100). |
efter | string | Markøren fra "naeste" i forrige svar. |
Eksempel på svar (opdigtede tal)
[
{
"nr": "2026-041",
"dato": "2026-10-01",
"forfald": "2026-10-09",
"periode_fra": "2026-09-01",
"periode_til": "2026-09-30",
"beloeb_ekskl_moms": "4000.00",
"moms": "1000.00",
"i_alt": "5000.00",
"betalt": false,
"betalt_dato": null
}
]
Fejl: 403 scope_mangler, 400 ugyldig_parameter, 400 ugyldig_markoer
GET/portal/api/v1/budget/
Budget (resultatbudgettet)
Resultatbudgettet for regnskabsåret som på siden Budget: det faktiske og budgettet pr. måned. Som siden: indtægter med plus og udgifter med minus.
Adgang: budget:laes
| Parameter | Type | Beskrivelse |
aar | string | Regnskabsårets id fra virksomhed/ (standard: indeværende år). |
Eksempel på svar (opdigtede tal)
{
"aar": "2026",
"godkendt": false,
"maaneder": [
"2026-01"
],
"resultat_prognose": "120000.00",
"linjer": [
{
"slags": "konto",
"noegle": "1010",
"navn": "1010 Salg af ydelser",
"prognose": "900000.00",
"maaneder": [
{
"maaned": "2026-01",
"faktisk": "70000.00",
"budget": "70000.00"
}
]
}
]
}
Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet
GET/portal/api/v1/noegletal/
Nøgletal
Nøgletallene, regnet af portalen (ingen AI, koster intet). Samme form som AI-API'et.
Adgang: noegletal:laes
Eksempel på svar (opdigtede tal)
{
"virksomhed": "Nordlys Design ApS",
"tilstand": "test",
"noegletal": {
"omsaetning": {
"now": 842500.0,
"before": 790000.0
},
"resultat": {
"now": 112000.0
},
"likvider_i_dag": 215000.0
}
}
Fejl: 403 scope_mangler, 403 ikke_delt, 409 ikke_hentet
GET/portal/api/v1/status/
Status
Virksomheden, hentningen, nøglens adgang og månedens forbrug af AI-spørgsmål.
Alle nøgler.
Eksempel på svar (opdigtede tal)
{
"virksomhed": "Nordlys Design ApS",
"nøgle": "Sandkassen",
"regnskab_hentet": "2026-10-14T06:00:00+02:00",
"tilstand": "test",
"scopes": [
"regnskab:laes"
],
"maaned": {
"spoergsmaal": 0,
"loft": 0,
"pris_kr": "0.00"
}
}
Fejl: 401 mangler_noegle, 401 ukendt_noegle
POST/portal/api/v1/spoerg/
Spørg AI-assistenten
AI-API'et: et spørgsmål om virksomhedens regnskab (kun live-nøgler, betalt pr. spørgsmål). Body: {"spoergsmaal": "..."}.
Adgang: ai:spoerg
Eksempel på svar (opdigtede tal)
{
"svar": "Omsætningen er steget 7 % i forhold til samme periode sidste år.",
"grafer": [],
"utjekkede_tal": [],
"pris_kr": "1.00",
"virksomhed": "Nordlys Design ApS"
}
Fejl: 403 ikke_slaaet_til, 403 ikke_i_testtilstand, 429 for_mange_kald, 502 ai_fejl
GET/portal/api/v1/openapi.json
OpenAPI-beskrivelsen
Denne beskrivelse som OpenAPI 3.1 (offentlig - ingen nøgle).
Offentlig - ingen nøgle.
Eksempel på svar (opdigtede tal)
{
"openapi": "3.1.0"
}
Paginering
posteringer/ og fakturaer/ er delt i sider: antal (1-500, standard 100) og efter = naeste fra forrige svar. Er naeste null, er der ikke flere. Markøren hører til nøglen, endpointet og filtrene. posteringer/: er tallene hentet igen siden første side, svarer API'et 409 markoer_udloebet - start forfra. fakturaer/: næste side fortsætter efter den sidste faktura på forrige side (fakturadato og rækkefølge), så en faktura, der ændres imens (fx bliver betalt), hverken springes over eller kommer to gange.