Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Python SDK to access Xero APIs

Project description


Python SDK to access Xero APIs


  1. Python 3+
  2. Requests library


Install Xero SDK using pip as follows:

pip install xerosdk


This SDK requires OAuth2 authentication credentials such as client ID, client secret and refresh token.

  1. Create a connection using the XeroSDK class.
from xerosdk import XeroSDK 

connection = XeroSDK(
    client_id='<YOUR CLIENT ID>',
    client_secret='<YOUR CLIENT SECRET>',
    refresh_token='<YOUR REFRESH TOKEN>'

# tenant_id is required to make a call to any API
tenant_id = connection.tenants.get_all()[0]['tenantId']
  1. Access any of the API classes

# Get a list of all Invoices
response = connection.invoices.get_all()

# Get an Invoice by id
response = connection.invoices.get_by_id(<invoice_id>)

NOTE: Only Tenants, Invoices, Accounts, Contacts, Items and TrackingCategories API classes are defined in this SDK.

Integration Tests

  1. Install pytest package using pip as follows:
pip install pytest
  1. Create a 'test_credentials.json' file at project root directory and enter Xero OAuth2 authentication credentials of your Xero app.
  "base_url": "<xero_base_url>",
  "client_id": "<client_id>",
  "client_secret": "<client_secret>",
  "refresh_token": "<refresh_token>"
  1. Run integration tests as follows:
python -m pytest tests/integration

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for xerosdk, version 0.8.0
Filename, size File type Python version Upload date Hashes
Filename, size xerosdk-0.8.0-py3-none-any.whl (13.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size xerosdk-0.8.0.tar.gz (8.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page