Dinero API: a practical guide
What you need to know to read data from Dinero: sign-in via Visma Connect, one organisation per call, fields you have to ask for and entries that can only be read within one accounting year. The examples use exactly the URLs and parameters JaKonto itself calls.
Contents
Authentication: OAuth 2.0 via Visma Connect
Dinero uses Visma Connect. Send the user to connect.visma.com/connect/authorize with your client_id, scopes and redirect_uri; exchange the returned code for tokens at connect.visma.com/connect/token with grant_type=authorization_code as a url-encoded form.
Scopes are dineropublicapi:read, dineropublicapi:write and offline_access — only the ones you were approved for. With offline_access you also get a refresh_token, so the user doesn't have to sign in again. API calls send Authorization: Bearer <access_token>.
https://connect.visma.com/connect/authorize
?client_id=<CLIENT_ID>&response_type=code
&scope=dineropublicapi:read dineropublicapi:write offline_access
&redirect_uri=https://example.com/dinero/callback&state=<STATE>
curl -X POST https://connect.visma.com/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code=<CODE>&redirect_uri=https://example.com/dinero/callback" \
-d "client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>"
Organisations and the Pro requirement
A user can have several organisations. Fetch them with /v1/organizations and put the organisation id in the path of everything else: /v1/{organizationId}/invoices and so on.
The API needs a Dinero Pro or Total subscription. Without it only /v1/organizations works; calls on the organisation's data are refused with HTTP 403 and code 90.
curl https://api.dinero.dk/v1/organizations \
-H "Authorization: Bearer <ACCESS_TOKEN>"
→ [{"id": 123456, "name": "…", "isPro": true}]
Invoices: page, pageSize and fields
Lists take page and pageSize. The invoice list returns only a few fields unless you ask for more with fields — without TotalExclVat and TotalInclVat your totals come out as 0.
curl -G https://api.dinero.dk/v1/<ORG_ID>/invoices \
--data-urlencode 'page=0' --data-urlencode 'pageSize=100' \
--data-urlencode 'fields=Guid,Number,ContactName,Date,PaymentDate,Currency,Status,TotalExclVat,TotalInclVat' \
-H "Authorization: Bearer <ACCESS_TOKEN>"
Entries: only within one accounting year
/v1/{organizationId}/entries needs fromDate and toDate, and both must fall in the same accounting year — otherwise Dinero answers with code 82. If your period spans several years, split it per accounting year.
The response is a bare array, not an object with Collection like the invoice list.
curl -G https://api.dinero.dk/v1/<ORG_ID>/entries \
--data-urlencode 'fromDate=2026-01-01' --data-urlencode 'toDate=2026-06-30' \
-H "Authorization: Bearer <ACCESS_TOKEN>"
→ [{"AccountNumber": 1000, "Amount": -1250.0, "Date": "2026-01-14", …}]
Pitfalls we hit ourselves
- Casing is mixed: /organizations answers in camelCase (id, name, isPro), lists and entries in PascalCase (Guid, TotalInclVat, AccountNumber, Amount). Read both.
- The rate limit is enforced: 100 calls per minute per organisation for partners, 60 per minute per client for personal integrations. Above that the API answers 429.
- Webhooks exist only for entries and only for Visma Connect integrations, not API-key integrations: GET /v1/{organizationId}/webhooks/events and POST …/webhooks/subscribe.
- Amounts are kroner with decimals; convert to øre (integers) before you add them up.
JaKonto and Dinero
JaKonto's Dinero integration via Visma Connect is built, with the same fields as from e-conomic and Billy, and will be switched on later. Until then you can get a free API key and try the API on e-conomic's demo company — your calls stay the same when Dinero opens.
Questions
Where is the official Dinero API documentation?
At developer.dinero.dk (guides) and api.dinero.dk/openapi (endpoints).
Does the Dinero API work with free Dinero?
No. It needs Dinero Pro or Total; without it you can only call /v1/organizations.
How many calls may I make?
100 per minute per organisation for partners and 60 per minute per client for personal integrations. Above that Dinero answers 429.
Does Dinero have webhooks?
Yes, for entries and only for Visma Connect integrations.
Does JaKonto write to Dinero?
No. JaKonto only reads.
e-conomic API integration · Billy API integration · Dinero API integration · MCP server