POST /BankTransactions

Default value: "application/json"

Xero identifier for Tenant

This allows you to safely retry requests without the risk of duplicate processing. 128 character max.

e.g. unitdp=4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts

If false return 200 OK and mix of successfully created objects and any with validation errors

Default value: false

Line amounts are exclusive of tax by default if you don’t specify this element. See Line Amount Types

Possible values:

• "Inclusive"
• "Exclusive"
• "NoTax"

Date of transaction – YYYY-MM-DD

URL link to a source document – shown as “Go to App Name”

See Bank Transaction Types

Possible values:

• "RECEIVE-TRANSFER"
• "RECEIVE-PREPAYMENT"
• "SPEND-TRANSFER"
• "RECEIVE"
• "RECEIVE-OVERPAYMENT"
• "SPEND-PREPAYMENT"
• "SPEND"
• "SPEND-OVERPAYMENT"

A string to indicate if a invoice status

Total of bank transaction tax inclusive

Reference for the transaction. Only supported for SPEND and RECEIVE transactions.

Total tax on bank transaction

See LineItems

LineItem Quantity

LineItem Unit Amount

The tax amount is auto calculated as a percentage of the line amount (see below) based on the tax rate. This value can be overriden if the calculated is not correct.

See Accounts

The Xero identifier for a Repeating Invoice

LineItem unique ID

Description needs to be at least 1 char long. A line item with just a description (i.e no unit amount or quantity) can be created by specifying just a element that contains at least 1 character

The tax type from TaxRates

The type of taxability

Possible values:

• "NOT_APPLICABLE"
• "EXEMPT"
• "PART_TAXABLE"
• "TAXABLE"
• "NON_TAXABLE"

An array of tax components defined for this line item

The unique ID number of this component

The name of the jurisdiction

The type of the jurisdiction

Possible values:

• "SYSGST/USSPECIAL"
• "SYSGST/USCOUNTRY"
• "SYSGST/USCOUNTY"
• "SYSGST/USSTATE"
• "SYSGST/USCITY"

The amount of the tax

The amount that is taxable

The amount that is not taxable

The percentage of the tax

The amount that is exempt

The state assigned number of the jurisdiction

Name identifying the region within the country

If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero will calculate the missing amount for you. The line amount reflects the discounted price if either a DiscountRate or DiscountAmount has been used i.e. LineAmount = Quantity * Unit Amount * ((100 - DiscountRate)/100) or LineAmount = (Quantity * UnitAmount) - DiscountAmount

The associated account ID related to this line item

The ID of the sales tax code

See Items

Optional Tracking Category – see Tracking. Any LineItem can have a maximum of 2 elements.

The Xero identifier for a tracking category

The name of the tracking category

See Tracking Options

The Xero identifier for a tracking category option

Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes. ACCPAY invoices and credit notes in Xero do not support discounts.

Percentage discount being applied to a line item (only supported on ACCREC invoices – ACC PAY invoices and credit notes in Xero do not support discounts

Last modified date UTC format

Total of bank transaction excluding taxes

Xero generated unique identifier for bank transaction

Exchange rate to base currency when money is spent or received. e.g.0.7500 Only used for bank transactions in non base currency. If this isn’t specified for non base currency accounts then either the user-defined rate (preference) or the XE.com day rate will be used. Setting currency is only supported on overpayments.

See Bank Transaction Status Codes

Possible values:

• "DELETED"
• "AUTHORISED"
• "VOIDED"

Xero generated unique identifier for an Overpayment. This will be returned on BankTransactions with a Type of SPEND-OVERPAYMENT or RECEIVE-OVERPAYMENT

Displays array of validation error messages from the API

Validation error message

Boolean to show if transaction is reconciled

Bank account number of contact

Website address for contact (read only)

Full name of contact/organisation (max length = 255)

The default sales tracking categories for contacts

The default purchase tracking category name for contacts

The default sales tracking category name for contacts

The default sales line amount type for a contact. Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.

Possible values:

• "INCLUSIVE"
• "NONE"
• "EXCLUSIVE"

The name of the Tracking Option assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories

Tax number of contact – this is also known as the ABN (Australia), GST Number (New Zealand), VAT Number (UK) or Tax ID Number (US and global) in the Xero UI depending on which regionalized version of Xero you are using (max length = 50)

The name of the Tracking Category assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories

Last name of contact person (max length = 255)

true or false – Boolean that describes if a contact that has any AP invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts payable invoice is generated against this contact.

The default purchases tracking categories for contacts

The default purchase tracking category name for contacts

The default sales tracking category name for contacts

UTC timestamp of last update to contact

Name of branding theme

Xero identifier

Always INVOICE

Possible values:

• "INVOICE"

The location of the image file used as the logo on this branding theme

Integer – ranked order of branding theme. The default branding theme has a value of 0

UTC timestamp of creation date of branding theme

true or false – Boolean that describes if a contact has any AR invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts receivable invoice is generated against this contact.

The default purchases line amount type for a contact Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.

Possible values:

• "INCLUSIVE"
• "NONE"
• "EXCLUSIVE"

Displays array of attachments from the API

Length of the file content

Include the file with the online invoice

Unique ID for the file

Type of file

URL to the file on xero.com

Name of the file

The default purchases account code for contacts

Xero identifier

The tax type from TaxRates

Current status of a contact – see contact status types

Possible values:

• "ARCHIVED"
• "ACTIVE"
• "GDPRREQUEST"

Store certain address types for a contact – see address types

max length = 255

define the type of address

Possible values:

• "STREET"
• "POBOX"

max length = 255

max length = 500

max length = 255

max length = 50, [A-Z], [a-z] only

max length = 500

max length = 500

max length = 500

max length = 50

Status of object

Company registration number (max length = 50)

Store certain phone types for a contact – see phone types

Possible values:

• "DEFAULT"
• "OFFICE"
• "DDI"
• "MOBILE"
• "FAX"

max length = 50

max length = 10

max length = 20

Bank details for use on a batch payment stored with each contact

First name of contact person (max length = 255)

The default sales account code for contacts

This can be updated via the API only i.e. This field is read only on the Xero contact screen, used to identify contacts in external systems (max length = 50). If the Contact Number is used, this is displayed as Contact Code in the Contacts UI in Xero.

The tax type from TaxRates

3 letter alpha code for the currency – see list of currency codes

Possible values:

• "ISK"
• "JMD"
• "LTL"
• "SVC"
• "SAR"
• "EEK"
• "TTD"
• "SBD"
• "SHP"
• "GBP"
• "TRY"
• "MOP"
• "INR"
• "MAD"
• "CUP"
• "CLF"
• "SRD"
• "SZL"
• "IRR"
• "CHF"
• "EUR"
• "KZT"
• "ALL"
• "MZN"
• "CDF"
• "BZD"
• "KES"
• "AOA"
• "NGN"
• "SEK"
• "BND"
• "UYU"
• "BRL"
• "YER"
• "ANG"
• "BYR"
• "MRO"
• "DJF"
• "LSL"
• "BBD"
• "MGA"
• "VND"
• "DOP"
• "TJS"
• "FJD"
• "BGN"
• "TWD"
• "QAR"
• "VES"
• "CNY"
• "AUD"
• "ZMW"
• "WST"
• "MDL"
• "KHR"
• "NZD"
• "AMD"
• "AZN"
• "TZS"
• "GIP"
• "AED"
• "AFN"
• "DZD"
• "PKR"
• "KYD"
• "AWG"
• "BSD"
• "PEN"
• "XAF"
• "NAD"
• "ZWD"
• "BTN"
• "KRW"
• "NPR"
• "FKP"
• "TND"
• "LVL"
• "MWK"
• "JOD"
• "LRD"
• "RSD"
• "SCR"
• "HUF"
• "IDR"
• "LAK"
• "UAH"
• "ZAR"
• "OMR"
• "PGK"
• "SLL"
• "MVR"
• "USD"
• "MXV"
• "MKD"
• "COP"
• "CAD"
• "KMF"
• "MXN"
• "PYG"
• "XCD"
• "STD"
• "IQD"
• "TOP"
• "VEF"
• "VUV"
• "SOS"
• "CVE"
• "CUC"
• "KGS"
• "TMT"
• "THB"
• "BOB"
• "UZS"
• "BYN"
• "SKK"
• "ILS"
• "PLN"
• "RON"
• "BHD"
• "BIF"
• "SLE"
• "XPF"
• "ARS"
• "GTQ"
• "RUB"
• "HKD"
• "ZMK"
• "RWF"
• "BDT"
• "ETB"
• "LYD"
• "JPY"
• "SGD"
• "STN"
• "MNT"
• "NIO"
• "GEL"
• "MUR"
• "NOK"
• "ERN"
• "SYP"
• "MYR"
• "DKK"
• "HRK"
• "CLP"
• "GNF"
• "GMD"
• "BAM"
• "HTG"
• "LBP"
• "PHP"
• "EGP"
• "SDG"
• "CRC"
• "CZK"
• "KWD"
• "KPW"
• "GHS"
• "GYD"
• "LKR"
• "BMD"
• "BWP"
• "MRU"
• "PAB"
• "UGX"
• "MMK"
• "XOF"
• "HNL"

A boolean to indicate if a contact has an validation errors

Default value: false

A user defined account number. This can be updated via the API and the Xero UI (max length = 50)

The raw AccountsReceivable(sales invoices) and AccountsPayable(bills) outstanding and overdue amounts, not converted to base currency (read only)

Store XeroNetworkKey for contacts.

The default discount rate for the contact (read only)

ID for the destination of a merged contact. Only returned when using paging or when fetching a contact by ContactId or ContactNumber.

Displays validation errors returned from the API

Validation error message

Email address of contact person (umlauts not supported) (max length = 255)

A boolean to indicate if a contact has an attachment

Default value: false

Day of Month (0-31)

Possible values:

• "DAYSAFTERBILLMONTH"
• "OFCURRENTMONTH"
• "DAYSAFTERBILLDATE"
• "OFFOLLOWINGMONTH"

Day of Month (0-31)

Possible values:

• "DAYSAFTERBILLMONTH"
• "OFCURRENTMONTH"
• "DAYSAFTERBILLDATE"
• "OFFOLLOWINGMONTH"

Displays which contact groups a contact is included in

The Name of the contact group. Required when creating a new contact group

The Status of a contact group. To delete a contact group update the status to DELETED. Only contact groups with a status of ACTIVE are returned on GETs.

Possible values:

• "DELETED"
• "ACTIVE"

The Xero identifier for an contact group – specified as a string following the endpoint name. e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9

The ContactID and Name of Contacts in a contact group. Returned on GETs when the ContactGroupID is supplied in the URL.

See contact persons

boolean to indicate whether contact should be included on emails with invoices etc.

Email address of person

Last name of person

First name of person

Boolean to indicate if a bank transaction has an attachment

Default value: false

Customer defined alpha numeric account code e.g 200 or SALES (max length = 10)

Boolean – describes whether account can have payments applied to it

Name of account (max length = 150)

See Account Types

Possible values:

• "BANK"
• "DEPRECIATN"
• "CURRENT"
• "FIXED"
• "EQUITY"
• "NONCURRENT"
• "PREPAYMENT"
• "PAYG"
• "EXPENSE"
• "LIABILITY"
• "TERMLIAB"
• "DIRECTCOSTS"
• "INVENTORY"
• "SALES"
• "OTHERINCOME"
• "CURRLIAB"
• "OVERHEADS"
• "REVENUE"

Boolean – describes whether account code is available for use with expense claims

For bank accounts only (Account Type BANK)

Shown if set

Description of the Account. Valid for all types of accounts except bank accounts (max length = 4000)

The tax type from taxRates

Boolean – describes whether the account is shown in the watchlist widget on the dashboard

See Account Class Types

Possible values:

• "ASSET"
• "EQUITY"
• "EXPENSE"
• "LIABILITY"
• "REVENUE"

Last modified date UTC format

For bank accounts only. See Bank Account types

Possible values:

• "CREDITCARD"
• ""
• "BANK"
• "PAYPAL"
• "NONE"

If this is a system account then this element is returned. See System Account types. Note that non-system accounts may have this element set as either “” or null.

Possible values:

• ""
• "TRACKINGTRANSFERS"
• "CISMATERIALS"
• "CISLABOURINCOME"
• "CISLIABILITY"
• "CISLABOUR"
• "CISLABOUREXPENSE"
• "GSTONIMPORTS"
• "UNPAIDEXPCLM"
• "CISASSETS"
• "CISASSET"
• "REALISEDCURRENCYGAIN"
• "UNREALISEDCURRENCYGAIN"
• "BANKCURRENCYGAIN"
• "ROUNDING"
• "HISTORICAL"
• "GST"
• "WAGEPAYABLES"
• "DEBTORS"
• "CREDITORS"
• "RETAINEDEARNINGS"

Accounts with a status of ACTIVE can be updated to ARCHIVED. See Account Status Codes

Possible values:

• "ARCHIVED"
• "DELETED"
• "ACTIVE"

Shown if set

The Xero identifier for an account – specified as a string following the endpoint name e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9

Displays array of validation error messages from the API

Validation error message

boolean to indicate if an account has an attachment (read only)

Default value: false

3 letter alpha code for the currency – see list of currency codes

Possible values:

• "ISK"
• "JMD"
• "LTL"
• "SVC"
• "SAR"
• "EEK"
• "TTD"
• "SBD"
• "SHP"
• "GBP"
• "TRY"
• "MOP"
• "INR"
• "MAD"
• "CUP"
• "CLF"
• "SRD"
• "SZL"
• "IRR"
• "CHF"
• "EUR"
• "KZT"
• "ALL"
• "MZN"
• "CDF"
• "BZD"
• "KES"
• "AOA"
• "NGN"
• "SEK"
• "BND"
• "UYU"
• "BRL"
• "YER"
• "ANG"
• "BYR"
• "MRO"
• "DJF"
• "LSL"
• "BBD"
• "MGA"
• "VND"
• "DOP"
• "TJS"
• "FJD"
• "BGN"
• "TWD"
• "QAR"
• "VES"
• "CNY"
• "AUD"
• "ZMW"
• "WST"
• "MDL"
• "KHR"
• "NZD"
• "AMD"
• "AZN"
• "TZS"
• "GIP"
• "AED"
• "AFN"
• "DZD"
• "PKR"
• "KYD"
• "AWG"
• "BSD"
• "PEN"
• "XAF"
• "NAD"
• "ZWD"
• "BTN"
• "KRW"
• "NPR"
• "FKP"
• "TND"
• "LVL"
• "MWK"
• "JOD"
• "LRD"
• "RSD"
• "SCR"
• "HUF"
• "IDR"
• "LAK"
• "UAH"
• "ZAR"
• "OMR"
• "PGK"
• "SLL"
• "MVR"
• "USD"
• "MXV"
• "MKD"
• "COP"
• "CAD"
• "KMF"
• "MXN"
• "PYG"
• "XCD"
• "STD"
• "IQD"
• "TOP"
• "VEF"
• "VUV"
• "SOS"
• "CVE"
• "CUC"
• "KGS"
• "TMT"
• "THB"
• "BOB"
• "UZS"
• "BYN"
• "SKK"
• "ILS"
• "PLN"
• "RON"
• "BHD"
• "BIF"
• "SLE"
• "XPF"
• "ARS"
• "GTQ"
• "RUB"
• "HKD"
• "ZMK"
• "RWF"
• "BDT"
• "ETB"
• "LYD"
• "JPY"
• "SGD"
• "STN"
• "MNT"
• "NIO"
• "GEL"
• "MUR"
• "NOK"
• "ERN"
• "SYP"
• "MYR"
• "DKK"
• "HRK"
• "CLP"
• "GNF"
• "GMD"
• "BAM"
• "HTG"
• "LBP"
• "PHP"
• "EGP"
• "SDG"
• "CRC"
• "CZK"
• "KWD"
• "KPW"
• "GHS"
• "GYD"
• "LKR"
• "BMD"
• "BWP"
• "MRU"
• "PAB"
• "UGX"
• "MMK"
• "XOF"
• "HNL"

3 letter alpha code for the currency – see list of currency codes

Possible values:

• "ISK"
• "JMD"
• "LTL"
• "SVC"
• "SAR"
• "EEK"
• "TTD"
• "SBD"
• "SHP"
• "GBP"
• "TRY"
• "MOP"
• "INR"
• "MAD"
• "CUP"
• "CLF"
• "SRD"
• "SZL"
• "IRR"
• "CHF"
• "EUR"
• "KZT"
• "ALL"
• "MZN"
• "CDF"
• "BZD"
• "KES"
• "AOA"
• "NGN"
• "SEK"
• "BND"
• "UYU"
• "BRL"
• "YER"
• "ANG"
• "BYR"
• "MRO"
• "DJF"
• "LSL"
• "BBD"
• "MGA"
• "VND"
• "DOP"
• "TJS"
• "FJD"
• "BGN"
• "TWD"
• "QAR"
• "VES"
• "CNY"
• "AUD"
• "ZMW"
• "WST"
• "MDL"
• "KHR"
• "NZD"
• "AMD"
• "AZN"
• "TZS"
• "GIP"
• "AED"
• "AFN"
• "DZD"
• "PKR"
• "KYD"
• "AWG"
• "BSD"
• "PEN"
• "XAF"
• "NAD"
• "ZWD"
• "BTN"
• "KRW"
• "NPR"
• "FKP"
• "TND"
• "LVL"
• "MWK"
• "JOD"
• "LRD"
• "RSD"
• "SCR"
• "HUF"
• "IDR"
• "LAK"
• "UAH"
• "ZAR"
• "OMR"
• "PGK"
• "SLL"
• "MVR"
• "USD"
• "MXV"
• "MKD"
• "COP"
• "CAD"
• "KMF"
• "MXN"
• "PYG"
• "XCD"
• "STD"
• "IQD"
• "TOP"
• "VEF"
• "VUV"
• "SOS"
• "CVE"
• "CUC"
• "KGS"
• "TMT"
• "THB"
• "BOB"
• "UZS"
• "BYN"
• "SKK"
• "ILS"
• "PLN"
• "RON"
• "BHD"
• "BIF"
• "SLE"
• "XPF"
• "ARS"
• "GTQ"
• "RUB"
• "HKD"
• "ZMK"
• "RWF"
• "BDT"
• "ETB"
• "LYD"
• "JPY"
• "SGD"
• "STN"
• "MNT"
• "NIO"
• "GEL"
• "MUR"
• "NOK"
• "ERN"
• "SYP"
• "MYR"
• "DKK"
• "HRK"
• "CLP"
• "GNF"
• "GMD"
• "BAM"
• "HTG"
• "LBP"
• "PHP"
• "EGP"
• "SDG"
• "CRC"
• "CZK"
• "KWD"
• "KPW"
• "GHS"
• "GYD"
• "LKR"
• "BMD"
• "BWP"
• "MRU"
• "PAB"
• "UGX"
• "MMK"
• "XOF"
• "HNL"

Xero generated unique identifier for a Prepayment. This will be returned on BankTransactions with a Type of SPEND-PREPAYMENT or RECEIVE-PREPAYMENT

Displays array of warning messages from the API

Validation error message