VAT Codes

VAT code and rate endpoints

List VAT codes

GET

https://api.ledgerbee.com/api

/v1/vat-codes

x-api-key (header)

OAuth 2.0

Retrieves all VAT codes for your company, sorted by VAT code. VAT codes define the rate and booking principle used to calculate VAT on journal entries — pass a VAT code's id as vatCodeId on a journal-entry or draft-journal-entry line to apply it.

Each code also carries the ledger account (and contra account) the VAT amount is booked to. Results are cached for 5 seconds.

Required Scope

vat-codes-read

List VAT codes › Responses

List of VAT codes and rates for the company

VatCodeResponse[]

VatCodeResponse

id

string · required

The unique identifier of the VAT code

Example: 550e8400-e29b-41d4-a716-446655440000

vatCode

string · required

VAT code identifier

Example: VAT25

name

string · required

Name/description of the VAT code

Example: 25% Standard VAT

vatRate

number · required

VAT rate percentage

Example: 25

type

string · required

VAT type

Example: Output/sales

principle

string · required

VAT principle - Gross (VAT included) or Net (VAT excluded)

Example: gross

accountToBookId

string

The ledger account ID to book VAT to

Example: 550e8400-e29b-41d4-a716-446655440001

accountToBookNumber

number

The ledger account number to book VAT to

Example: 6910

accountToBookName

string

The ledger account name to book VAT to

Example: Output VAT

contraAccountToBookId

string

The contra account ID for VAT entries

Example: 550e8400-e29b-41d4-a716-446655440002

contraAccountToBookNumber

number

The contra account number for VAT entries

Example: 6920

contraAccountToBookName

string

The contra account name for VAT entries

Example: Input VAT

Subscriptions Webhook Endpoints

LedgerBee Public API

VAT Codes

Download schema

VAT code and rate endpoints

List VAT codes

GET

https://api.ledgerbee.com/api

/v1/vat-codes

x-api-key (header)

OAuth 2.0

Each code also carries the ledger account (and contra account) the VAT amount is booked to. Results are cached for 5 seconds.

Required Scope

vat-codes-read

List VAT codes › Responses

List of VAT codes and rates for the company

VatCodeResponse[]

VatCodeResponse

id

string · required

The unique identifier of the VAT code

Example: 550e8400-e29b-41d4-a716-446655440000

vatCode

string · required

VAT code identifier

Example: VAT25

name

string · required

Name/description of the VAT code

Example: 25% Standard VAT

vatRate

number · required

VAT rate percentage

Example: 25

type

string · required

VAT type

Example: Output/sales

principle

string · required

VAT principle - Gross (VAT included) or Net (VAT excluded)

Example: gross

accountToBookId

string

The ledger account ID to book VAT to

Example: 550e8400-e29b-41d4-a716-446655440001

accountToBookNumber

number

The ledger account number to book VAT to

Example: 6910

accountToBookName

string

The ledger account name to book VAT to

Example: Output VAT

contraAccountToBookId

string

The contra account ID for VAT entries

Example: 550e8400-e29b-41d4-a716-446655440002

contraAccountToBookNumber

number

The contra account number for VAT entries

Example: 6920

contraAccountToBookName

string

The contra account name for VAT entries

Example: Input VAT

Subscriptions Webhook Endpoints