Journal Entries

Create, change and book entries. Create a draft, upload its document, then book it.

Endpoints

The journal entry object

idstring (uuid)
Transaction ID
datestring· nullable
Transaction date
textstring· nullable
Transaction description
statusstring· nullable
Transaction status (draft entries are 'open')
contact_idstring (uuid)· nullable
Associated contact (customer/supplier) ID
created_atstring· nullable
Transaction creation timestamp (ISO 8601, UTC)
external_referencestring· nullable
The external_reference sent when the entry was created
linesarray of objects
On a draft, the lines as entered, with VAT included in the amount. On a booked entry, the posted ledger entries, with VAT on its own line. Empty on a canceled entry.
+Show 9 child attributesHide child attributes
- idstring (uuid)
  Journal entry line ID
- account_numberinteger· nullable
  Account number
- account_idstring· nullable
  Account ID
- account_namestring
  Account name
- amountnumber
  Signed amount in currency_code: debit is positive, credit is negative. On a draft it includes VAT. On a booked entry VAT is on its own line.
- textstring· nullable
  Line description
- vat_codestring· nullable
  VAT code if applicable
- currency_codestring
  Currency of the line. Entries created through this API are always DKK; entries created in Numina can be in another currency.
- currency_ratenumber
  Rate to DKK. 1 for DKK.
statestring
Where the entry stands. status keeps the raw value, which can differ between drafts.
One ofdraftbookedcanceled
attachmentobject· nullable
The document on this entry
+Show 4 child attributesHide child attributes
- idstring (uuid)
- file_namestring· nullable
- statusstring· nullable
- attachment_numbernumber· nullable
  The bilag number, normally assigned when the entry is booked. Numbers restart each accounting year.

Endpoints

GET    /v1/journal-entries
POST   /v1/journal-entries
GET    /v1/journal-entries/{id}
PUT    /v1/journal-entries/{id}
DELETE /v1/journal-entries/{id}
POST   /v1/journal-entries/{id}/book

The journal entry object

Object

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-01-15",
  "text": "Invoice payment from customer",
  "status": "open",
  "contact_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-01-15T10:30:00Z",
  "external_reference": "payroll-run-2026-01",
  "lines": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "account_number": 3000,
      "account_id": "550e8400-e29b-41d4-a716-446655440001",
      "account_name": "Revenue",
      "amount": -1000,
      "text": "Invoice payment",
      "vat_code": "U25",
      "currency_code": "DKK",
      "currency_rate": 1
    }
  ],
  "state": "draft",
  "attachment": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "file_name": "string",
    "status": "string",
    "attachment_number": 42
  }
}