Invoices

Download schema

List invoices

GET

https://api.ledgerbee.com/api

/v1/invoices

x-api-key (header)

OAuth 2.0

Returns a paginated list of invoices for your company, optionally filtered by status and customer.

Required Scope

invoices-read

List invoices › query Parameters

page

number · min: 1

Page number (1-indexed)

Example: 1

Default: 1

limit

number · min: 1 · max: 100

Number of items per page

Example: 25

Default: 25

search

string

Free-text search (invoice number, description)

status

string · enum

Filter invoices by status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

customerId

string

Filter invoices for a specific customer

Example: 0197A943-2325-7829-B835-B6C71A293065

List invoices › Responses

Paginated list of invoices

PublicListInvoicesResponse

PublicInvoiceListItem[] · required

Invoices on this page (line items omitted; GET one invoice for lines)

total

number · required

Total invoices matching the query

Example: 42

page

number · required

Current page (1-indexed)

Example: 1

limit

number · required

Items per page

Example: 25

totalPages

number · required

Total pages

Example: 2

Create a draft invoice

POST

https://api.ledgerbee.com/api

/v1/invoices

x-api-key (header)

OAuth 2.0

Creates a draft invoice. The invoice number is allocated at booking time (when sent), so a draft has no number yet.

Required Scope

invoices-write

Create a draft invoice › Headers

x-api-idempotency-key

string · maxLength: 255

Optional idempotency key for safely retrying mutating requests.

Create a draft invoice › Request Body

PublicCreateInvoice

customerId

string · required

Customer ID this invoice is for. Required — every invoice must reference a customer (this mirrors the gated app, which also requires a customer).

Example: 0197A943-2325-7829-B835-B6C71A293065

date

string · required

Invoice date (ISO date, YYYY-MM-DD)

Example: 2024-01-15

PublicCreateInvoiceLine[] · required

Invoice lines

customerDepartmentId

string

Customer department ID (for EAN-based e-invoicing and address override)

Example: 0197A943-2325-7829-B835-B6C71A293065

customerContactId

string

Customer contact ID (invoice recipient)

Example: 0197A943-2325-7829-B835-B6C71A293065

dueDate

string

Due date for payment (ISO date). Derived from payment terms when omitted.

Example: 2024-02-15

currency

string · minLength: 3 · maxLength: 3

Currency code (ISO 4217). Defaults to the company default currency.

Example: DKK

paymentTerms

number

Payment terms in days

Example: 30

reference

string

Reference / PO number ("PO-nr.")

Example: PO-12345

ourReference

string

Our reference ("Vores ref.")

Example: Jane Doe

description

string

Optional description of the invoice

Example: Monthly service invoice

notes

string

Additional notes or comments

Example: Thank you for your business!

Create a draft invoice › Responses

Invoice created successfully

PublicInvoice

id

string · required

Invoice ID

Example: 0197A943-2325-7829-B835-B6C71A293065

status

string · enum · required

Invoice status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

Example: sent

date

string · required

Invoice date (ISO date)

Example: 2024-01-15

currency

string · required

Currency code (ISO 4217)

Example: DKK

subtotal

string · required

Subtotal before VAT (decimal string)

Example: 2166.65

vat

string · required

VAT amount (decimal string)

Example: 541.66

amount

string · required

Total amount including VAT (decimal string)

Example: 2708.31

PublicInvoiceLine[] · required

Invoice lines

createdAt

string · required

Creation timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

updatedAt

string · required

Last update timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

number

string | null

Invoice number. Null while the invoice is still a draft (allocated at booking).

dueDate

string | null

Due date (ISO date)

customerId

string | null

Customer ID

reference

string | null

Reference / PO number

ourReference

string | null

Our reference ("Vores ref.")

notes

string | null

Additional notes

POST/v1/invoices

curl https://api.ledgerbee.com/api/v1/invoices \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "customerId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerDepartmentId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerContactId": "0197A943-2325-7829-B835-B6C71A293065",
  "date": "2024-01-15",
  "dueDate": "2024-02-15",
  "currency": "DKK",
  "paymentTerms": 30,
  "reference": "PO-12345",
  "ourReference": "Jane Doe",
  "description": "Monthly service invoice",
  "notes": "Thank you for your business!",
  "lines": [
    {
      "priceId": "0197A943-2325-7829-B835-B6C71A293065",
      "lineType": "subscription",
      "description": "Premium widget - Blue color",
      "quantity": 2,
      "unitPrice": "1083.32",
      "recognitionPeriodDays": 365
    }
  ]
}'

Example Request Body

{
  "customerId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerDepartmentId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerContactId": "0197A943-2325-7829-B835-B6C71A293065",
  "date": "2024-01-15",
  "dueDate": "2024-02-15",
  "currency": "DKK",
  "paymentTerms": 30,
  "reference": "PO-12345",
  "ourReference": "Jane Doe",
  "description": "Monthly service invoice",
  "notes": "Thank you for your business!",
  "lines": [
    {
      "priceId": "0197A943-2325-7829-B835-B6C71A293065",
      "lineType": "subscription",
      "description": "Premium widget - Blue color",
      "quantity": 2,
      "unitPrice": "1083.32",
      "recognitionPeriodDays": 365
    }
  ]
}

json

application/json

Example Responses

{
  "id": "0197A943-2325-7829-B835-B6C71A293065",
  "number": "number",
  "status": "sent",
  "date": "2024-01-15",
  "dueDate": "dueDate",
  "customerId": "customerId",
  "currency": "DKK",
  "subtotal": "2166.65",
  "vat": "541.66",
  "amount": "2708.31",
  "reference": "reference",
  "ourReference": "ourReference",
  "notes": "notes",
  "lines": [
    {
      "id": "0197A943-2325-7829-B835-B6C71A293065",
      "priceId": "priceId",
      "description": "description",
      "lineType": "subscription",
      "quantity": 2,
      "unitPrice": "1083.32",
      "totalPrice": "2166.65",
      "vatAmount": "vatAmount",
      "vatRate": "vatRate"
    }
  ],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

json

application/json

Get an invoice

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}

x-api-key (header)

OAuth 2.0

Retrieves a single invoice by its unique identifier. Returns 404 when the invoice does not exist in your company. For the rendered document, use the PDF endpoint.

Required Scope

invoices-read

Get an invoice › path Parameters

id

string · required

Invoice ID

Get an invoice › Responses

The invoice

PublicInvoice

id

string · required

Invoice ID

Example: 0197A943-2325-7829-B835-B6C71A293065

status

string · enum · required

Invoice status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

Example: sent

date

string · required

Invoice date (ISO date)

Example: 2024-01-15

currency

string · required

Currency code (ISO 4217)

Example: DKK

subtotal

string · required

Subtotal before VAT (decimal string)

Example: 2166.65

vat

string · required

VAT amount (decimal string)

Example: 541.66

amount

string · required

Total amount including VAT (decimal string)

Example: 2708.31

PublicInvoiceLine[] · required

Invoice lines

createdAt

string · required

Creation timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

updatedAt

string · required

Last update timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

number

string | null

Invoice number. Null while the invoice is still a draft (allocated at booking).

dueDate

string | null

Due date (ISO date)

customerId

string | null

Customer ID

reference

string | null

Reference / PO number

ourReference

string | null

Our reference ("Vores ref.")

notes

string | null

Additional notes

GET/v1/invoices/{id}

curl https://api.ledgerbee.com/api/v1/invoices/:id \
  --header 'x-api-key: <api-key>'

Example Responses

{
  "id": "0197A943-2325-7829-B835-B6C71A293065",
  "number": "number",
  "status": "sent",
  "date": "2024-01-15",
  "dueDate": "dueDate",
  "customerId": "customerId",
  "currency": "DKK",
  "subtotal": "2166.65",
  "vat": "541.66",
  "amount": "2708.31",
  "reference": "reference",
  "ourReference": "ourReference",
  "notes": "notes",
  "lines": [
    {
      "id": "0197A943-2325-7829-B835-B6C71A293065",
      "priceId": "priceId",
      "description": "description",
      "lineType": "subscription",
      "quantity": 2,
      "unitPrice": "1083.32",
      "totalPrice": "2166.65",
      "vatAmount": "vatAmount",
      "vatRate": "vatRate"
    }
  ],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

json

application/json

Get the delivery status of an invoice

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}/delivery-status

x-api-key (header)

OAuth 2.0

Returns an aggregate send summary plus a per-attempt delivery log for the invoice.

Required Scope

invoices-read

Get the delivery status of an invoice › path Parameters

id

string · required

Invoice ID

Get the delivery status of an invoice › Responses

Delivery status

PublicDeliveryStatusResponse

object · required

Aggregate send summary

PublicDeliveryLogEntry[] · required

Per-attempt delivery log entries

Download the invoice PDF

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}/pdf

x-api-key (header)

OAuth 2.0

Streams the rendered invoice PDF. Pass draft=true to render a draft watermark version (generated on the fly).

Required Scope

invoices-read

Download the invoice PDF › path Parameters

id

string · required

Invoice ID

Download the invoice PDF › query Parameters

draft

boolean

Render a draft watermark version

Download the invoice PDF › Responses

Bad Request

statusCode

number

timestamp

string

path

string

message

string

Send an invoice to the customer

POST

https://api.ledgerbee.com/api

/v1/invoices/{id}/send

x-api-key (header)

OAuth 2.0

Sends the invoice over the chosen delivery channel (Email, Sproom e-invoicing, or Manual). Sending books the invoice and allocates its number.

Required Scope

invoices-write

Send an invoice to the customer › path Parameters

id

string · required

Invoice ID

Send an invoice to the customer › Headers

x-api-idempotency-key

string · maxLength: 255

Optional idempotency key for safely retrying mutating requests.

Send an invoice to the customer › Request Body

PublicSendInvoice

deliveryType

string · enum · required

Delivery channel

Enum values:

Sproom

Manual

Leverandorservice

Example: Email

overrideEmail

string

Override recipient email for this send only

overrideEanNumber

string

Override EAN number for this send only

updateCustomerRecord

boolean

Persist the override email / EAN onto the customer record

Default: false

documentTemplateId

string

Override document template for PDF generation

Send an invoice to the customer › Responses

Invoice send accepted

PublicSendInvoiceResponse

success

boolean · required

Whether the send was accepted

Example: true

deliveryType

string · enum · required

The delivery channel the document was sent through

Enum values:

Sproom

Manual

Leverandorservice

Example: Email

sproomDocumentId

string | null

Sproom document ID when sent via e-invoicing

Entitlements Journal Categories

LedgerBee Public API

Invoices

Download schema

List invoices

GET

https://api.ledgerbee.com/api

/v1/invoices

x-api-key (header)

OAuth 2.0

Returns a paginated list of invoices for your company, optionally filtered by status and customer.

Required Scope

invoices-read

List invoices › query Parameters

page

number · min: 1

Page number (1-indexed)

Example: 1

Default: 1

limit

number · min: 1 · max: 100

Number of items per page

Example: 25

Default: 25

search

string

Free-text search (invoice number, description)

status

string · enum

Filter invoices by status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

customerId

string

Filter invoices for a specific customer

Example: 0197A943-2325-7829-B835-B6C71A293065

List invoices › Responses

Paginated list of invoices

PublicListInvoicesResponse

PublicInvoiceListItem[] · required

Invoices on this page (line items omitted; GET one invoice for lines)

total

number · required

Total invoices matching the query

Example: 42

page

number · required

Current page (1-indexed)

Example: 1

limit

number · required

Items per page

Example: 25

totalPages

number · required

Total pages

Example: 2

Create a draft invoice

POST

https://api.ledgerbee.com/api

/v1/invoices

x-api-key (header)

OAuth 2.0

Creates a draft invoice. The invoice number is allocated at booking time (when sent), so a draft has no number yet.

Required Scope

invoices-write

Create a draft invoice › Headers

x-api-idempotency-key

string · maxLength: 255

Optional idempotency key for safely retrying mutating requests.

Create a draft invoice › Request Body

PublicCreateInvoice

customerId

string · required

Customer ID this invoice is for. Required — every invoice must reference a customer (this mirrors the gated app, which also requires a customer).

Example: 0197A943-2325-7829-B835-B6C71A293065

date

string · required

Invoice date (ISO date, YYYY-MM-DD)

Example: 2024-01-15

PublicCreateInvoiceLine[] · required

Invoice lines

customerDepartmentId

string

Customer department ID (for EAN-based e-invoicing and address override)

Example: 0197A943-2325-7829-B835-B6C71A293065

customerContactId

string

Customer contact ID (invoice recipient)

Example: 0197A943-2325-7829-B835-B6C71A293065

dueDate

string

Due date for payment (ISO date). Derived from payment terms when omitted.

Example: 2024-02-15

currency

string · minLength: 3 · maxLength: 3

Currency code (ISO 4217). Defaults to the company default currency.

Example: DKK

paymentTerms

number

Payment terms in days

Example: 30

reference

string

Reference / PO number ("PO-nr.")

Example: PO-12345

ourReference

string

Our reference ("Vores ref.")

Example: Jane Doe

description

string

Optional description of the invoice

Example: Monthly service invoice

notes

string

Additional notes or comments

Example: Thank you for your business!

Create a draft invoice › Responses

Invoice created successfully

PublicInvoice

id

string · required

Invoice ID

Example: 0197A943-2325-7829-B835-B6C71A293065

status

string · enum · required

Invoice status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

Example: sent

date

string · required

Invoice date (ISO date)

Example: 2024-01-15

currency

string · required

Currency code (ISO 4217)

Example: DKK

subtotal

string · required

Subtotal before VAT (decimal string)

Example: 2166.65

vat

string · required

VAT amount (decimal string)

Example: 541.66

amount

string · required

Total amount including VAT (decimal string)

Example: 2708.31

PublicInvoiceLine[] · required

Invoice lines

createdAt

string · required

Creation timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

updatedAt

string · required

Last update timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

number

string | null

Invoice number. Null while the invoice is still a draft (allocated at booking).

dueDate

string | null

Due date (ISO date)

customerId

string | null

Customer ID

reference

string | null

Reference / PO number

ourReference

string | null

Our reference ("Vores ref.")

notes

string | null

Additional notes

POST/v1/invoices

curl https://api.ledgerbee.com/api/v1/invoices \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "customerId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerDepartmentId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerContactId": "0197A943-2325-7829-B835-B6C71A293065",
  "date": "2024-01-15",
  "dueDate": "2024-02-15",
  "currency": "DKK",
  "paymentTerms": 30,
  "reference": "PO-12345",
  "ourReference": "Jane Doe",
  "description": "Monthly service invoice",
  "notes": "Thank you for your business!",
  "lines": [
    {
      "priceId": "0197A943-2325-7829-B835-B6C71A293065",
      "lineType": "subscription",
      "description": "Premium widget - Blue color",
      "quantity": 2,
      "unitPrice": "1083.32",
      "recognitionPeriodDays": 365
    }
  ]
}'

Example Request Body

{
  "customerId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerDepartmentId": "0197A943-2325-7829-B835-B6C71A293065",
  "customerContactId": "0197A943-2325-7829-B835-B6C71A293065",
  "date": "2024-01-15",
  "dueDate": "2024-02-15",
  "currency": "DKK",
  "paymentTerms": 30,
  "reference": "PO-12345",
  "ourReference": "Jane Doe",
  "description": "Monthly service invoice",
  "notes": "Thank you for your business!",
  "lines": [
    {
      "priceId": "0197A943-2325-7829-B835-B6C71A293065",
      "lineType": "subscription",
      "description": "Premium widget - Blue color",
      "quantity": 2,
      "unitPrice": "1083.32",
      "recognitionPeriodDays": 365
    }
  ]
}

json

application/json

Example Responses

{
  "id": "0197A943-2325-7829-B835-B6C71A293065",
  "number": "number",
  "status": "sent",
  "date": "2024-01-15",
  "dueDate": "dueDate",
  "customerId": "customerId",
  "currency": "DKK",
  "subtotal": "2166.65",
  "vat": "541.66",
  "amount": "2708.31",
  "reference": "reference",
  "ourReference": "ourReference",
  "notes": "notes",
  "lines": [
    {
      "id": "0197A943-2325-7829-B835-B6C71A293065",
      "priceId": "priceId",
      "description": "description",
      "lineType": "subscription",
      "quantity": 2,
      "unitPrice": "1083.32",
      "totalPrice": "2166.65",
      "vatAmount": "vatAmount",
      "vatRate": "vatRate"
    }
  ],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

json

application/json

Get an invoice

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}

x-api-key (header)

OAuth 2.0

Retrieves a single invoice by its unique identifier. Returns 404 when the invoice does not exist in your company. For the rendered document, use the PDF endpoint.

Required Scope

invoices-read

Get an invoice › path Parameters

id

string · required

Invoice ID

Get an invoice › Responses

The invoice

PublicInvoice

id

string · required

Invoice ID

Example: 0197A943-2325-7829-B835-B6C71A293065

status

string · enum · required

Invoice status

Enum values:

draft

scheduled

sending

sent

paid

partially_paid

cancelled

uncollectible

Example: sent

date

string · required

Invoice date (ISO date)

Example: 2024-01-15

currency

string · required

Currency code (ISO 4217)

Example: DKK

subtotal

string · required

Subtotal before VAT (decimal string)

Example: 2166.65

vat

string · required

VAT amount (decimal string)

Example: 541.66

amount

string · required

Total amount including VAT (decimal string)

Example: 2708.31

PublicInvoiceLine[] · required

Invoice lines

createdAt

string · required

Creation timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

updatedAt

string · required

Last update timestamp (ISO)

Example: 2024-01-15T10:30:00.000Z

number

string | null

Invoice number. Null while the invoice is still a draft (allocated at booking).

dueDate

string | null

Due date (ISO date)

customerId

string | null

Customer ID

reference

string | null

Reference / PO number

ourReference

string | null

Our reference ("Vores ref.")

notes

string | null

Additional notes

GET/v1/invoices/{id}

curl https://api.ledgerbee.com/api/v1/invoices/:id \
  --header 'x-api-key: <api-key>'

Example Responses

{
  "id": "0197A943-2325-7829-B835-B6C71A293065",
  "number": "number",
  "status": "sent",
  "date": "2024-01-15",
  "dueDate": "dueDate",
  "customerId": "customerId",
  "currency": "DKK",
  "subtotal": "2166.65",
  "vat": "541.66",
  "amount": "2708.31",
  "reference": "reference",
  "ourReference": "ourReference",
  "notes": "notes",
  "lines": [
    {
      "id": "0197A943-2325-7829-B835-B6C71A293065",
      "priceId": "priceId",
      "description": "description",
      "lineType": "subscription",
      "quantity": 2,
      "unitPrice": "1083.32",
      "totalPrice": "2166.65",
      "vatAmount": "vatAmount",
      "vatRate": "vatRate"
    }
  ],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

json

application/json

Get the delivery status of an invoice

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}/delivery-status

x-api-key (header)

OAuth 2.0

Returns an aggregate send summary plus a per-attempt delivery log for the invoice.

Required Scope

invoices-read

Get the delivery status of an invoice › path Parameters

id

string · required

Invoice ID

Get the delivery status of an invoice › Responses

Delivery status

PublicDeliveryStatusResponse

object · required

Aggregate send summary

PublicDeliveryLogEntry[] · required

Per-attempt delivery log entries

Download the invoice PDF

GET

https://api.ledgerbee.com/api

/v1/invoices/{id}/pdf

x-api-key (header)

OAuth 2.0

Streams the rendered invoice PDF. Pass draft=true to render a draft watermark version (generated on the fly).

Required Scope

invoices-read

Download the invoice PDF › path Parameters

id

string · required

Invoice ID

Download the invoice PDF › query Parameters

draft

boolean

Render a draft watermark version

Download the invoice PDF › Responses

Bad Request

statusCode

number

timestamp

string

path

string

message

string

Send an invoice to the customer

POST

https://api.ledgerbee.com/api

/v1/invoices/{id}/send

x-api-key (header)

OAuth 2.0

Sends the invoice over the chosen delivery channel (Email, Sproom e-invoicing, or Manual). Sending books the invoice and allocates its number.

Required Scope

invoices-write

Send an invoice to the customer › path Parameters

id

string · required

Invoice ID

Send an invoice to the customer › Headers

x-api-idempotency-key

string · maxLength: 255

Optional idempotency key for safely retrying mutating requests.

Send an invoice to the customer › Request Body

PublicSendInvoice

deliveryType

string · enum · required

Delivery channel

Enum values:

Sproom

Manual

Leverandorservice

Example: Email

overrideEmail

string

Override recipient email for this send only

overrideEanNumber

string

Override EAN number for this send only

updateCustomerRecord

boolean

Persist the override email / EAN onto the customer record

Default: false

documentTemplateId

string

Override document template for PDF generation

Send an invoice to the customer › Responses

Invoice send accepted

PublicSendInvoiceResponse

success

boolean · required

Whether the send was accepted

Example: true

deliveryType

string · enum · required

The delivery channel the document was sent through

Enum values:

Sproom

Manual

Leverandorservice

Example: Email

sproomDocumentId

string | null

Sproom document ID when sent via e-invoicing

Entitlements Journal Categories