InvoiceResponseDtoSuccessResultResponse

Wraps a successful API response with the result payload.

correlationIduuid

A unique ID of the request

Example: fb0ccbbc-62bc-447f-a47e-02b490e25690

isSuccessboolean

Indicates whether the request was successful. Always true for success responses.

Example: true

result object

Response model for Invoice

externalInvoiceIdstringrequired

The internal invoice identifier within your system. Is expected to be unique within the company.

Possible values: non-empty

Example: F50015

invoiceDatestringrequired

The invoice date (yyyy-MM-dd)

Possible values: non-empty

Example: 2022-07-25

postingDatestringnullable

Posting date of the invoice (yyyy-MM-dd)

Example: 2022-07-21

dueDatestringnullable

Payment due date (yyyy-MM-dd)

Example: 2022-08-15

currencyCodestringnullable

Three-digit ISO 4217 currency code

Possible values: >= 3 characters and <= 3 characters

Example: DKK

amountExVatdoublerequired

Total amount on the invoice not including VAT

Example: 324

vatAmountdoublerequired

The total VAT amount on the invoice

Example: 81

amountInclVatdoublerequired

Total amount on the invoice including VAT

Example: 405

externalPurchaserIdstringnullable

Unique identifier of the purchaser within your system. Is expected to be unique within the company.

Example: MKR

buyer object

Company DTO model.

externalIdstringnullable

Unique identifier of the company from your ERP system. Is expected to be unique.

Example: 1001abc

namestringnullable

Represents the name of the company

Example: Kaunt A/S

glnNumberstringnullable

The Global Location Number (GLN) of the company

Example: 574400338

taxIdentificationNumberstringnullable

The Tax Identification number (TIN) the company is registered under.

Example: 40865888

address object

Address DTO model.

addressstringnullable

Address

Example: Fiskerivej 12

citystringnullable

City name.

Example: Aarhus

zipCodestringnullable

Postal / ZIP code.

Example: 8000

countryCodestringnullable

3-letter ISO 3166 country code.

Example: DNK

contact object

Contact DTO model.

namestringnullable

Contact name

Example: Lori K. Myrie

emailAddressstringnullable

Email address for the contact

Example: mailtocontact@contact.com

phoneNumberstringnullable

Phone number for the contact

Example: +45 88 88 88 88

vendor object

Company DTO model.

externalIdstringnullable

Unique identifier of the company from your ERP system. Is expected to be unique.

Example: 1001abc

namestringnullable

Represents the name of the company

Example: Kaunt A/S

glnNumberstringnullable

The Global Location Number (GLN) of the company

Example: 574400338

taxIdentificationNumberstringnullable

The Tax Identification number (TIN) the company is registered under.

Example: 40865888

address object

Address DTO model.

addressstringnullable

Address

Example: Fiskerivej 12

citystringnullable

City name.

Example: Aarhus

zipCodestringnullable

Postal / ZIP code.

Example: 8000

countryCodestringnullable

3-letter ISO 3166 country code.

Example: DNK

contact object

Contact DTO model.

namestringnullable

Contact name

Example: Lori K. Myrie

emailAddressstringnullable

Email address for the contact

Example: mailtocontact@contact.com

phoneNumberstringnullable

Phone number for the contact

Example: +45 88 88 88 88

deliveryAddress object

Address DTO model.

addressstringnullable

Address

Example: Fiskerivej 12

citystringnullable

City name.

Example: Aarhus

zipCodestringnullable

Postal / ZIP code.

Example: 8000

countryCodestringnullable

3-letter ISO 3166 country code.

Example: DNK

deliveryContact object

Contact DTO model.

namestringnullable

Contact name

Example: Lori K. Myrie

emailAddressstringnullable

Email address for the contact

Example: mailtocontact@contact.com

phoneNumberstringnullable

Phone number for the contact

Example: +45 88 88 88 88

vendorInvoiceNumberstringnullable

Invoice id provided by the vendor

Example: Invoice-EN-175

orderNumberstringnullable

The number of the order to which the invoice is associated to

Example: 999554

purchaseOrderNumberstringnullable

The purchase order number associated with the invoice

Example: PO-2024-001

projectNumberstringnullable

Project number referenced on the invoice. Identifies the project the invoice relates to.

Example: PRJ-2024-018

contractNumberstringnullable

Contract number referenced on the invoice. Identifies the contract governing the invoiced work.

Example: CTR-50012

customerNumberstringnullable

The buyer's customer number as recorded by the vendor (the ID the vendor uses to identify this customer).

Example: CUST-77231

externalApproverIdstringnullable

Unique identifier of the first approver in the workflow. Is expected to be unique within the company.

Example: Jack Petterson

notestringnullable

Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures.

Example: Delivery to warehouse B, attention: John Smith

paymentInformation object

Payment information DTO model.

paymentMethodIdstringnullable

Identifier of the given payment method

Example: DirectPayment01

paymentReferencestringnullable

The reference of the payment

Example: T-155

paymentTermsIdstringnullable

Identifier for the payment terms

Example: WithoutVat-5

bankSwiftCodestringnullable

Bank swift code

Example: AAAA-BB-CC-123

bankIbanNumberstringnullable

Bank IBAN number

Example: AA12345678901234567890

invoiceLines object[]required

The invoice lines associated with the invoice

Possible values: >= 1

Array [

lineNumberstringnullable

The line sequence number

Example: 1

descriptionstringnullable

Specifies the description of the invoice line

Example: Macbook Pro 14 inch, 512gb SSD, 16GB RAM, Space Grey

namestringnullable

A short name optionally given to this item, such as a name from a catalogue, as distinct from a description

Example: MACBOOKPRO14-SG

quantitydoublenullable

The quantity of the item in the invoice line

Example: 1

unitOfMeasurestringnullable

Unit of measure for the invoice line

Example: Pcs

lineAmountExVatdoublerequired

The line amount not including VAT

Example: 108

lineVatAmountdoublerequired

The line VAT amount

Example: 27

lineAmountInclVatdoublerequired

The line amount including VAT

Example: 135

additionalFields objectnullable

Additional custom fields for flexible data storage

property name*string

]

allowanceCharges object[]nullable

Header-level allowance and charge items (discounts, surcharges, fees)

Array [

isChargebooleannullable

True = charge (increases total), false = allowance (decreases total)

Example: false

reasonstringnullable

Free-text reason for the allowance or charge

Example: Trade discount

reasonCodestringnullable

Standardized reason code (e.g. UBL AllowanceChargeReasonCode)

Example: 95

amountExVatdoublenullable

Amount excluding VAT

Example: 100

vatAmountdoublenullable

VAT amount

Example: 25

amountInclVatdoublenullable

Amount including VAT

Example: 125

]

additionalFields objectnullable

Additional custom fields for flexible data storage

property name*string

iduuid

The unique kaunt identifier of the invoice

Example: 88af81e1-1e47-4a60-8322-e5854bb6475f

attachments object[]nullable

The attachments associated with the invoice.

Array [

fileNamestringrequired

The filename including file ending.

Example: Invoice001.pdf

mimeTypestringrequired

The mimetype/media type of the file

Example: application/pdf

urlstringrequired

URL for downloading the filecontent of the attachment

Example: https://sandbox-api.kaunt.com/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/kaunt/files/d6281ec7-6fd4-4a13-be92-d3bebbcf79f7.pdf

]

origin object

Describes how an invoice entered the system.

channelstringrequired

The channel the invoice arrived through.

Possible values: [Api, EInvoice, Document]

Example: Document

receivedAtdate-timerequired

When the invoice was first received.

Example: 2026-08-10T09:12:04Z

enginestringnullable

The engine that read the document, for the document channel. Reported here rather than only alongside the document, since an invoice can be read by an engine that leaves no retrievable document behind.

Possible values: [DocumentAI, AzureFormRecognizer]

Example: DocumentAI

format object

The format an invoice was submitted in.

mimeTypestringnullable

The mime type of the submitted invoice.

Example: application/pdf

eInvoiceStandardstringnullable

The e-invoice standard, present for electronic invoices only.

Example: UBL

document object

The Document AI document an invoice was read from.

documentIdstringrequired

The Document AI document identifier.

Example: 7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f

enginestringrequired

The engine that read the document.

Possible values: [DocumentAI, AzureFormRecognizer]

Example: DocumentAI

urlstringnullable

URL of the document's metadata in Document AI. Omitted when the extraction service reported no URL. Requires access to the Document AI product, and the document may have been removed independently of the invoice.

Example: https://api.kaunt.com/v1/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/acme/documentai/documents/7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f

fileUrlstringnullable

URL for downloading the original document contents. Omitted with Url.

Example: https://api.kaunt.com/v1/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/acme/documentai/documents/7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f/file

InvoiceResponseDtoSuccessResultResponse

{
  "correlationId": "fb0ccbbc-62bc-447f-a47e-02b490e25690",
  "isSuccess": true,
  "result": {
    "externalInvoiceId": "F50015",
    "invoiceDate": "2022-07-25",
    "postingDate": "2022-07-21",
    "dueDate": "2022-08-15",
    "currencyCode": "DKK",
    "amountExVat": 324,
    "vatAmount": 81,
    "amountInclVat": 405,
    "externalPurchaserId": "MKR",
    "buyer": {
      "externalId": "1001abc",
      "name": "Kaunt A/S",
      "glnNumber": 574400338,
      "taxIdentificationNumber": 40865888,
      "address": {
        "address": "Fiskerivej 12",
        "city": "Aarhus",
        "zipCode": 8000,
        "countryCode": "DNK"
      },
      "contact": {
        "name": "Lori K. Myrie",
        "emailAddress": "mailtocontact@contact.com",
        "phoneNumber": "+45 88 88 88 88"
      }
    },
    "vendor": {
      "externalId": "1001abc",
      "name": "Kaunt A/S",
      "glnNumber": 574400338,
      "taxIdentificationNumber": 40865888,
      "address": {
        "address": "Fiskerivej 12",
        "city": "Aarhus",
        "zipCode": 8000,
        "countryCode": "DNK"
      },
      "contact": {
        "name": "Lori K. Myrie",
        "emailAddress": "mailtocontact@contact.com",
        "phoneNumber": "+45 88 88 88 88"
      }
    },
    "deliveryAddress": {
      "address": "Fiskerivej 12",
      "city": "Aarhus",
      "zipCode": 8000,
      "countryCode": "DNK"
    },
    "deliveryContact": {
      "name": "Lori K. Myrie",
      "emailAddress": "mailtocontact@contact.com",
      "phoneNumber": "+45 88 88 88 88"
    },
    "vendorInvoiceNumber": "Invoice-EN-175",
    "orderNumber": 999554,
    "purchaseOrderNumber": "PO-2024-001",
    "projectNumber": "PRJ-2024-018",
    "contractNumber": "CTR-50012",
    "customerNumber": "CUST-77231",
    "externalApproverId": "Jack Petterson",
    "note": "Delivery to warehouse B, attention: John Smith",
    "paymentInformation": {
      "paymentMethodId": "DirectPayment01",
      "paymentReference": "T-155",
      "paymentTermsId": "WithoutVat-5",
      "bankSwiftCode": "AAAA-BB-CC-123",
      "bankIbanNumber": "AA12345678901234567890"
    },
    "invoiceLines": [
      {
        "lineNumber": 1,
        "description": "Macbook Pro 14 inch, 512gb SSD, 16GB RAM, Space Grey",
        "name": "MACBOOKPRO14-SG",
        "quantity": 1,
        "unitOfMeasure": "Pcs",
        "lineAmountExVat": 108,
        "lineVatAmount": 27,
        "lineAmountInclVat": 135,
        "additionalFields": {
          "customField1": "value1",
          "customField2": "value2"
        }
      }
    ],
    "allowanceCharges": [
      {
        "isCharge": false,
        "reason": "Trade discount",
        "reasonCode": 95,
        "amountExVat": 100,
        "vatAmount": 25,
        "amountInclVat": 125
      }
    ],
    "additionalFields": {
      "customField1": "value1",
      "customField2": "value2"
    },
    "id": "88af81e1-1e47-4a60-8322-e5854bb6475f",
    "attachments": [
      {
        "fileName": "Invoice001.pdf",
        "mimeType": "application/pdf",
        "url": "https://sandbox-api.kaunt.com/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/kaunt/files/d6281ec7-6fd4-4a13-be92-d3bebbcf79f7.pdf"
      }
    ],
    "origin": {
      "channel": "Document",
      "receivedAt": "2026-08-10T09:12:04Z",
      "engine": "DocumentAI",
      "format": {
        "mimeType": "application/pdf",
        "eInvoiceStandard": "UBL"
      },
      "document": {
        "documentId": "7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f",
        "engine": "DocumentAI",
        "url": "https://api.kaunt.com/v1/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/acme/documentai/documents/7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f",
        "fileUrl": "https://api.kaunt.com/v1/tenants/05ed0ffa-1bf5-4bd1-9970-df7a78a948fe/companies/acme/documentai/documents/7f3c1e88-4a2b-4c19-9f0e-1d2c3b4a5e6f/file"
      }
    }
  }
}