Developers

PUBLIC API v1

Create a new invoice

POST /api/v1/companies/{company_pk}/invoices/

Create a new invoice for the company

Permission: write_invoices · Direct link

Company-scoped. Account permissions, plan limits and document state still apply.

Path and query parameters

ParameterLocation / typeDescription
company_pkRequiredpath · string (uuid)Not specified

Request body

application/json

FieldType / accepted valuesDescription
clientstring (uuid) | nullNot specified
clientDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
addressstringNot specified
citystringNot specified
zipCodestringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
vatNumberstringNot specified
emailstring (email)Not specified
phonestringNot specified
companyDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
currencystringNot specified
addressstring | nullNot specified
zipCodestringNot specified
citystringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
taxState"bayern" | "baden-wurttemberg" | "berlin" | "brandenburg" | "bremen" | "hamburg" | "hessen" | "mecklenburg-vorpommern" | "niedersachsen" | "nordrhein-westfalen" | "rheinland-pfalz" | "saarland" | "sachsen" | "sachsen-anhalt" | "schleswig-holstein" | "thuringen"* `bayern` - Bayern * `baden-wurttemberg` - Baden-Württemberg * `berlin` - Berlin * `brandenburg` - Brandenburg * `bremen` - Bremen * `hamburg` - Hamburg * `hessen` - Hessen * `mecklenburg-vorpommern` - Mecklenburg-Vorpommern * `niedersachsen` - Niedersachsen * `nordrhein-westfalen` - Nordrhein-Westfalen * `rheinland-pfalz` - Rheinland-Pfalz * `saarland` - Saarland * `sachsen` - Sachsen * `sachsen-anhalt` - Sachsen-Anhalt * `schleswig-holstein` - Schleswig-Holstein * `thuringen` - Thüringen
vatNumberstring | nullNot specified
taxNumberstring | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
bankNamestring | nullNot specified
invoiceType"GOODS" | "SERVICES"* `GOODS` - Goods * `SERVICES` - Services
invoiceNumberRequiredstringNot specified
paymentStatus"paid" | "unpaid"* `paid` - Paid * `unpaid` - Unpaid
status"draft" | "pending" | "overdue" | "paid" | "uncollectible" | "removed" | "saved" | "sent" | "approved"* `draft` - Draft * `pending` - Pending * `overdue` - Overdue * `paid` - Paid * `uncollectible` - Uncollectible * `removed` - Removed * `saved` - Saved * `sent` - Sent * `approved` - Approved
issuedstring (date) | nullNot specified
deliveryDatestring (date) | nullNot specified
dueTostring (date) | nullNot specified
serviceStartDatestring (date) | nullNot specified
serviceEndDatestring (date) | nullNot specified
discountPercentsintegerNot specified
currencystringNot specified
currencyExchangedstringNot specified
invoicedItemsobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
idstring | nullThe line's id (UUID), assigned by the server when the line is first written. Echo it on an update so the line keeps its identity; leave it out for a new line.
nameRequiredstringNot specified
quantityRequirednumber (double)Not specified
rateRequiredintegerNot specified
vatRateRequiredintegerNot specified
itemPriceNetintegerNot specified
itemPriceGrossintegerNot specified
itemVatAmountintegerNot specified
discountPercentnumber (double)Not specified
itemDiscountAmountintegerNot specified
descriptionstringNot specified
discountNotestringDeprecated, use description.
unit"items" | "hours" | "days" | "kilograms" | "liters" | "meters" | "square_meters" | "" | nullNot specified
productIdstring | nullNot specified
companyCategorystring | nullNot specified
gtuCode"GTU_01" | "GTU_02" | "GTU_03" | "GTU_04" | "GTU_05" | "GTU_06" | "GTU_07" | "GTU_08" | "GTU_09" | "GTU_10" | "GTU_11" | "GTU_12" | "GTU_13" | ""Not specified
isSplitPaymentbooleanNot specified
paymentTermsstringNot specified
notesstringNot specified
instructionsstringNot specified
messagestringNot specified
language"de" | "en" | "pl" | "it" | "es"* `de` - German * `en` - English * `pl` - Polish * `it` - Italian * `es` - Spanish
isVatIncludedbooleanNot specified
bankAccountPkstringNot specified
reportUrlstring (binary) | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
isToSendbooleanNot specified
paymentDatestring (date) | nullNot specified
isToCreateTransactionbooleanNot specified
paidAmountintegerNot specified
bankNamestring | nullNot specified
companyEmailstring (email)Not specified
fullCostOriginExchangedstring (decimal) | nullNot specified
createQrbooleanNot specified
skipBankDetailsbooleanNot specified
saveClientDetailsbooleanNot specified
settingsOnOverdueobject | nullNot specified
Nested fields
FieldType / accepted valuesDescription
isToAutosendNotificationbooleanNot specified
notifyAfterDaysinteger[]Not specified
notifyInParticularDaysstring (date)[]Not specified
customEmailBodystring | nullNot specified
customEmailSubjectstring | nullNot specified
colorSchemastringNot specified
fontstringNot specified
mailingDataobject | nullNot specified
type"invoice" | "quote" | "delivery_note" | "cancel"* `invoice` - Invoice * `quote` - Quote * `delivery_note` - Delivery note * `cancel` - Cancel Invoice
taxExemptReasonstringNot specified
onlinePaymentEnabledbooleanNot specified
sourceContractstring (uuid) | nullNot specified

multipart/form-data

FieldType / accepted valuesDescription
clientstring (uuid) | nullNot specified
clientDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
addressstringNot specified
citystringNot specified
zipCodestringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
vatNumberstringNot specified
emailstring (email)Not specified
phonestringNot specified
companyDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
currencystringNot specified
addressstring | nullNot specified
zipCodestringNot specified
citystringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
taxState"bayern" | "baden-wurttemberg" | "berlin" | "brandenburg" | "bremen" | "hamburg" | "hessen" | "mecklenburg-vorpommern" | "niedersachsen" | "nordrhein-westfalen" | "rheinland-pfalz" | "saarland" | "sachsen" | "sachsen-anhalt" | "schleswig-holstein" | "thuringen"* `bayern` - Bayern * `baden-wurttemberg` - Baden-Württemberg * `berlin` - Berlin * `brandenburg` - Brandenburg * `bremen` - Bremen * `hamburg` - Hamburg * `hessen` - Hessen * `mecklenburg-vorpommern` - Mecklenburg-Vorpommern * `niedersachsen` - Niedersachsen * `nordrhein-westfalen` - Nordrhein-Westfalen * `rheinland-pfalz` - Rheinland-Pfalz * `saarland` - Saarland * `sachsen` - Sachsen * `sachsen-anhalt` - Sachsen-Anhalt * `schleswig-holstein` - Schleswig-Holstein * `thuringen` - Thüringen
vatNumberstring | nullNot specified
taxNumberstring | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
bankNamestring | nullNot specified
invoiceType"GOODS" | "SERVICES"* `GOODS` - Goods * `SERVICES` - Services
invoiceNumberRequiredstringNot specified
paymentStatus"paid" | "unpaid"* `paid` - Paid * `unpaid` - Unpaid
status"draft" | "pending" | "overdue" | "paid" | "uncollectible" | "removed" | "saved" | "sent" | "approved"* `draft` - Draft * `pending` - Pending * `overdue` - Overdue * `paid` - Paid * `uncollectible` - Uncollectible * `removed` - Removed * `saved` - Saved * `sent` - Sent * `approved` - Approved
issuedstring (date) | nullNot specified
deliveryDatestring (date) | nullNot specified
dueTostring (date) | nullNot specified
serviceStartDatestring (date) | nullNot specified
serviceEndDatestring (date) | nullNot specified
discountPercentsintegerNot specified
currencystringNot specified
currencyExchangedstringNot specified
invoicedItemsobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
idstring | nullThe line's id (UUID), assigned by the server when the line is first written. Echo it on an update so the line keeps its identity; leave it out for a new line.
nameRequiredstringNot specified
quantityRequirednumber (double)Not specified
rateRequiredintegerNot specified
vatRateRequiredintegerNot specified
itemPriceNetintegerNot specified
itemPriceGrossintegerNot specified
itemVatAmountintegerNot specified
discountPercentnumber (double)Not specified
itemDiscountAmountintegerNot specified
descriptionstringNot specified
discountNotestringDeprecated, use description.
unit"items" | "hours" | "days" | "kilograms" | "liters" | "meters" | "square_meters" | "" | nullNot specified
productIdstring | nullNot specified
companyCategorystring | nullNot specified
gtuCode"GTU_01" | "GTU_02" | "GTU_03" | "GTU_04" | "GTU_05" | "GTU_06" | "GTU_07" | "GTU_08" | "GTU_09" | "GTU_10" | "GTU_11" | "GTU_12" | "GTU_13" | ""Not specified
isSplitPaymentbooleanNot specified
paymentTermsstringNot specified
notesstringNot specified
instructionsstringNot specified
messagestringNot specified
language"de" | "en" | "pl" | "it" | "es"* `de` - German * `en` - English * `pl` - Polish * `it` - Italian * `es` - Spanish
isVatIncludedbooleanNot specified
bankAccountPkstringNot specified
reportUrlstring (binary) | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
isToSendbooleanNot specified
paymentDatestring (date) | nullNot specified
isToCreateTransactionbooleanNot specified
paidAmountintegerNot specified
bankNamestring | nullNot specified
companyEmailstring (email)Not specified
fullCostOriginExchangedstring (decimal) | nullNot specified
createQrbooleanNot specified
skipBankDetailsbooleanNot specified
saveClientDetailsbooleanNot specified
settingsOnOverdueobject | nullNot specified
Nested fields
FieldType / accepted valuesDescription
isToAutosendNotificationbooleanNot specified
notifyAfterDaysinteger[]Not specified
notifyInParticularDaysstring (date)[]Not specified
customEmailBodystring | nullNot specified
customEmailSubjectstring | nullNot specified
colorSchemastringNot specified
fontstringNot specified
mailingDataobject | nullNot specified
type"invoice" | "quote" | "delivery_note" | "cancel"* `invoice` - Invoice * `quote` - Quote * `delivery_note` - Delivery note * `cancel` - Cancel Invoice
taxExemptReasonstringNot specified
onlinePaymentEnabledbooleanNot specified
sourceContractstring (uuid) | nullNot specified

application/x-www-form-urlencoded

FieldType / accepted valuesDescription
clientstring (uuid) | nullNot specified
clientDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
addressstringNot specified
citystringNot specified
zipCodestringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
vatNumberstringNot specified
emailstring (email)Not specified
phonestringNot specified
companyDataobjectNot specified
Nested fields
FieldType / accepted valuesDescription
nameRequiredstringNot specified
currencystringNot specified
addressstring | nullNot specified
zipCodestringNot specified
citystringNot specified
country"AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW"* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe
taxState"bayern" | "baden-wurttemberg" | "berlin" | "brandenburg" | "bremen" | "hamburg" | "hessen" | "mecklenburg-vorpommern" | "niedersachsen" | "nordrhein-westfalen" | "rheinland-pfalz" | "saarland" | "sachsen" | "sachsen-anhalt" | "schleswig-holstein" | "thuringen"* `bayern` - Bayern * `baden-wurttemberg` - Baden-Württemberg * `berlin` - Berlin * `brandenburg` - Brandenburg * `bremen` - Bremen * `hamburg` - Hamburg * `hessen` - Hessen * `mecklenburg-vorpommern` - Mecklenburg-Vorpommern * `niedersachsen` - Niedersachsen * `nordrhein-westfalen` - Nordrhein-Westfalen * `rheinland-pfalz` - Rheinland-Pfalz * `saarland` - Saarland * `sachsen` - Sachsen * `sachsen-anhalt` - Sachsen-Anhalt * `schleswig-holstein` - Schleswig-Holstein * `thuringen` - Thüringen
vatNumberstring | nullNot specified
taxNumberstring | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
bankNamestring | nullNot specified
invoiceType"GOODS" | "SERVICES"* `GOODS` - Goods * `SERVICES` - Services
invoiceNumberRequiredstringNot specified
paymentStatus"paid" | "unpaid"* `paid` - Paid * `unpaid` - Unpaid
status"draft" | "pending" | "overdue" | "paid" | "uncollectible" | "removed" | "saved" | "sent" | "approved"* `draft` - Draft * `pending` - Pending * `overdue` - Overdue * `paid` - Paid * `uncollectible` - Uncollectible * `removed` - Removed * `saved` - Saved * `sent` - Sent * `approved` - Approved
issuedstring (date) | nullNot specified
deliveryDatestring (date) | nullNot specified
dueTostring (date) | nullNot specified
serviceStartDatestring (date) | nullNot specified
serviceEndDatestring (date) | nullNot specified
discountPercentsintegerNot specified
currencystringNot specified
currencyExchangedstringNot specified
invoicedItemsobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
idstring | nullThe line's id (UUID), assigned by the server when the line is first written. Echo it on an update so the line keeps its identity; leave it out for a new line.
nameRequiredstringNot specified
quantityRequirednumber (double)Not specified
rateRequiredintegerNot specified
vatRateRequiredintegerNot specified
itemPriceNetintegerNot specified
itemPriceGrossintegerNot specified
itemVatAmountintegerNot specified
discountPercentnumber (double)Not specified
itemDiscountAmountintegerNot specified
descriptionstringNot specified
discountNotestringDeprecated, use description.
unit"items" | "hours" | "days" | "kilograms" | "liters" | "meters" | "square_meters" | "" | nullNot specified
productIdstring | nullNot specified
companyCategorystring | nullNot specified
gtuCode"GTU_01" | "GTU_02" | "GTU_03" | "GTU_04" | "GTU_05" | "GTU_06" | "GTU_07" | "GTU_08" | "GTU_09" | "GTU_10" | "GTU_11" | "GTU_12" | "GTU_13" | ""Not specified
isSplitPaymentbooleanNot specified
paymentTermsstringNot specified
notesstringNot specified
instructionsstringNot specified
messagestringNot specified
language"de" | "en" | "pl" | "it" | "es"* `de` - German * `en` - English * `pl` - Polish * `it` - Italian * `es` - Spanish
isVatIncludedbooleanNot specified
bankAccountPkstringNot specified
reportUrlstring (binary) | nullNot specified
ibanstring | nullNot specified
bicstring | nullNot specified
isToSendbooleanNot specified
paymentDatestring (date) | nullNot specified
isToCreateTransactionbooleanNot specified
paidAmountintegerNot specified
bankNamestring | nullNot specified
companyEmailstring (email)Not specified
fullCostOriginExchangedstring (decimal) | nullNot specified
createQrbooleanNot specified
skipBankDetailsbooleanNot specified
saveClientDetailsbooleanNot specified
settingsOnOverdueobject | nullNot specified
Nested fields
FieldType / accepted valuesDescription
isToAutosendNotificationbooleanNot specified
notifyAfterDaysinteger[]Not specified
notifyInParticularDaysstring (date)[]Not specified
customEmailBodystring | nullNot specified
customEmailSubjectstring | nullNot specified
colorSchemastringNot specified
fontstringNot specified
mailingDataobject | nullNot specified
type"invoice" | "quote" | "delivery_note" | "cancel"* `invoice` - Invoice * `quote` - Quote * `delivery_note` - Delivery note * `cancel` - Cancel Invoice
taxExemptReasonstringNot specified
onlinePaymentEnabledbooleanNot specified
sourceContractstring (uuid) | nullNot specified

Responses

201 Response fields

application/json

FieldType / accepted valuesDescription
publicIdRequiredRead onlystring (uuid)Not specified
type"invoice" | "quote" | "delivery_note" | "cancel"* `invoice` - Invoice * `quote` - Quote * `delivery_note` - Delivery note * `cancel` - Cancel Invoice
vatNumberstringNot specified
companystring (uuid) | nullNot specified
clientstring (uuid) | nullNot specified
invoiceNumberRequiredstringNot specified
paymentStatusRequiredstringNot specified
statusRequiredstringNot specified
issuedstring (date) | nullNot specified
deliveryDatestring (date) | nullNot specified
dueTostring (date) | nullNot specified
serviceStartDatestring (date) | nullNot specified
serviceEndDatestring (date) | nullNot specified
paymentDatestring (date) | nullNot specified
discountPercentsintegerNot specified
currencyRequiredstringNot specified
currencyExchangedRequiredstringNot specified
invoicedItemsRequiredobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
idstring | nullThe line's id (UUID), assigned by the server when the line is first written. Echo it on an update so the line keeps its identity; leave it out for a new line.
nameRequiredstringNot specified
quantityRequirednumber (double)Not specified
rateRequiredintegerNot specified
vatRateRequiredintegerNot specified
itemPriceNetintegerNot specified
itemPriceGrossintegerNot specified
itemVatAmountintegerNot specified
discountPercentnumber (double)Not specified
itemDiscountAmountintegerNot specified
descriptionstringNot specified
discountNotestringDeprecated, use description.
unit"items" | "hours" | "days" | "kilograms" | "liters" | "meters" | "square_meters" | "" | nullNot specified
productIdstring | nullNot specified
companyCategorystring | nullNot specified
gtuCode"GTU_01" | "GTU_02" | "GTU_03" | "GTU_04" | "GTU_05" | "GTU_06" | "GTU_07" | "GTU_08" | "GTU_09" | "GTU_10" | "GTU_11" | "GTU_12" | "GTU_13" | ""Not specified
isSplitPaymentbooleanNot specified
taxExemptReasonstringNot specified
paymentTermsstringNot specified
notesstringNot specified
instructionsstringNot specified
messagestringNot specified
language"de" | "en" | "pl" | "it" | "es"* `de` - German * `en` - English * `pl` - Polish * `it` - Italian * `es` - Spanish
fullCostinteger (int64) | nullNot specified
isVatIncludedbooleanNot specified
reportUrlstring (uri) | nullNot specified
transactionsRequiredstring (uuid)[]Not specified
invoiceType"GOODS" | "SERVICES"* `GOODS` - Goods * `SERVICES` - Services
companyEmailstring (email) | nullNot specified
fullCostOriginstring (decimal) | nullNot specified
fullCostOriginExchangedstring (decimal) | nullNot specified
createQrbooleanNot specified
ibanRequiredRead onlystringNot specified
bicRequiredRead onlystringNot specified
bankNameRequiredRead onlystringNot specified
historySnapshotobject | nullNot specified
remindersRequiredRead onlyobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
levelRequiredintegerNot specified
feestring (decimal)Not specified
subjectstringNot specified
sentAtRequiredRead onlystring (date-time)Not specified
sourcestringNot specified
settingsOnOverdueobject | nullNot specified
colorSchemastringNot specified
fontstringNot specified
logostring (uri) | nullNot specified
recurringDataRequiredobjectNot specified
Nested fields
FieldType / accepted valuesDescription
publicIdRequiredRead onlystring (uuid)Not specified
invoicesRequiredobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
publicIdRequiredRead onlystring (uuid)Not specified
status"draft" | "pending" | "overdue" | "paid" | "uncollectible" | "removed" | "saved" | "sent" | "approved"* `draft` - Draft * `pending` - Pending * `overdue` - Overdue * `paid` - Paid * `uncollectible` - Uncollectible * `removed` - Removed * `saved` - Saved * `sent` - Sent * `approved` - Approved
contextobject | nullNot specified
baseInvoicesRequiredRead onlyobject[]Not specified
frequencyType"weekly" | "monthly"* `weekly` - Weekly * `monthly` - Monthly
frequencyUnitintegerNot specified
isOngoingbooleanNot specified
isToSendbooleanNot specified
ksefStatus"pending" | "submitted" | "accepted" | "rejected" | ""Not specified
ksefReferenceNumberstringNot specified
ksefSubmittedAtstring (date-time) | nullNot specified
isKsefReadonlyRequiredRead onlybooleanNot specified
onlinePaymentEnabledbooleanNot specified
sourceContractstring (uuid) | nullNot specified
onlinePaymentRequiredRead onlyobjectNot specified
401 Response fields

application/json

FieldType / accepted valuesDescription
detailRequiredRead onlystringNot specified
403 Missing scope, company mismatch, unsupported operation, or a plan/account restriction.
429 Rate limit exceeded. Wait for the Retry-After header before retrying.

Use the base URL https://api.norman.finance/api/v1. Sign up or log in to Norman to create an API key, then send it as a Bearer token. For an OpenAPI JSON file, contact support.