Xero · Schema

BankTransaction

AccountingBank FeedsFinanceFinancial-ServicesInvoicingPayrollSmall Business

Properties

Name Type Description
Type string See Bank Transaction Types
Contact object
LineItems array See LineItems
BankAccount object
IsReconciled boolean Boolean to show if transaction is reconciled
Date string Date of transaction – YYYY-MM-DD
Reference string Reference for the transaction. Only supported for SPEND and RECEIVE transactions.
CurrencyCode string
CurrencyRate number 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
Url string URL link to a source document – shown as “Go to App Name”
Status string See Bank Transaction Status Codes
LineAmountTypes string
SubTotal number Total of bank transaction excluding taxes
TotalTax number Total tax on bank transaction
Total number Total of bank transaction tax inclusive
BankTransactionID string Xero generated unique identifier for bank transaction
PrepaymentID string Xero generated unique identifier for a Prepayment. This will be returned on BankTransactions with a Type of SPEND-PREPAYMENT or RECEIVE-PREPAYMENT
OverpaymentID string Xero generated unique identifier for an Overpayment. This will be returned on BankTransactions with a Type of SPEND-OVERPAYMENT or RECEIVE-OVERPAYMENT
UpdatedDateUTC string Last modified date UTC format
HasAttachments boolean Boolean to indicate if a bank transaction has an attachment
StatusAttributeString string A string to indicate if a invoice status
ValidationErrors array Displays array of validation error messages from the API
View JSON Schema on GitHub

JSON Schema

xero-banktransaction-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/BankTransaction",
  "title": "BankTransaction",
  "externalDocs": {
    "url": "http://developer.xero.com/documentation/api/banktransactions/"
  },
  "properties": {
    "Type": {
      "description": "See Bank Transaction Types",
      "type": "string",
      "enum": [
        "RECEIVE",
        "RECEIVE-OVERPAYMENT",
        "RECEIVE-PREPAYMENT",
        "SPEND",
        "SPEND-OVERPAYMENT",
        "SPEND-PREPAYMENT",
        "RECEIVE-TRANSFER",
        "SPEND-TRANSFER"
      ]
    },
    "Contact": {
      "$ref": "#/components/schemas/Contact"
    },
    "LineItems": {
      "description": "See LineItems",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LineItem"
      }
    },
    "BankAccount": {
      "$ref": "#/components/schemas/Account"
    },
    "IsReconciled": {
      "description": "Boolean to show if transaction is reconciled",
      "type": "boolean"
    },
    "Date": {
      "description": "Date of transaction \u2013 YYYY-MM-DD",
      "type": "string",
      "x-is-msdate": true
    },
    "Reference": {
      "description": "Reference for the transaction. Only supported for SPEND and RECEIVE transactions.",
      "type": "string"
    },
    "CurrencyCode": {
      "$ref": "#/components/schemas/CurrencyCode",
      "type": "string"
    },
    "CurrencyRate": {
      "description": "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\u2019t 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.",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "Url": {
      "description": "URL link to a source document \u2013 shown as \u201cGo to App Name\u201d",
      "type": "string"
    },
    "Status": {
      "description": "See Bank Transaction Status Codes",
      "type": "string",
      "enum": [
        "AUTHORISED",
        "DELETED",
        "VOIDED"
      ]
    },
    "LineAmountTypes": {
      "$ref": "#/components/schemas/LineAmountTypes",
      "type": "string"
    },
    "SubTotal": {
      "description": "Total of bank transaction excluding taxes",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "TotalTax": {
      "description": "Total tax on bank transaction",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "Total": {
      "description": "Total of bank transaction tax inclusive",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "BankTransactionID": {
      "description": "Xero generated unique identifier for bank transaction",
      "type": "string",
      "format": "uuid",
      "example": "00000000-0000-0000-0000-000000000000"
    },
    "PrepaymentID": {
      "description": "Xero generated unique identifier for a Prepayment. This will be returned on BankTransactions with a Type of SPEND-PREPAYMENT or RECEIVE-PREPAYMENT",
      "readOnly": true,
      "type": "string",
      "format": "uuid",
      "example": "00000000-0000-0000-0000-000000000000"
    },
    "OverpaymentID": {
      "description": "Xero generated unique identifier for an Overpayment. This will be returned on BankTransactions with a Type of SPEND-OVERPAYMENT or RECEIVE-OVERPAYMENT",
      "readOnly": true,
      "type": "string",
      "format": "uuid",
      "example": "00000000-0000-0000-0000-000000000000"
    },
    "UpdatedDateUTC": {
      "description": "Last modified date UTC format",
      "type": "string",
      "x-is-msdate-time": true,
      "example": "/Date(1573755038314)/",
      "readOnly": true
    },
    "HasAttachments": {
      "description": "Boolean to indicate if a bank transaction has an attachment",
      "readOnly": true,
      "type": "boolean",
      "default": "false",
      "example": "false"
    },
    "StatusAttributeString": {
      "description": "A string to indicate if a invoice status",
      "type": "string"
    },
    "ValidationErrors": {
      "description": "Displays array of validation error messages from the API",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ValidationError"
      }
    }
  },
  "required": [
    "Type",
    "LineItems",
    "BankAccount"
  ],
  "type": "object"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/xero-banktransaction"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.