Xero Accounting API
Browse all Xero APIs57
AI ReadinessFoundational (C)57/100
Official vendor OpenAPI document · agent-readyFinanceAccountingoauth2237 EndpointsREST
For Agents
Create invoices, record payments, reconcile bank transactions, and generate financial reports for small businesses through Xero's double-entry accounting system.
Use for: I need to create an invoice for a client, Retrieve the balance sheet report for this financial year, I want to record a payment against an outstanding invoice, Find all overdue invoices for a specific contact
Not supported: Does not process card payments, manage payroll, or handle inventory tracking - use for double-entry accounting, invoicing, and financial reporting only.
Record and reconcile financial transactions, generate invoices, track payments, and produce financial reports for small and medium businesses. The API exposes 237 endpoints covering accounts, contacts, invoices, bank transactions, journals, and reporting - enabling full double-entry bookkeeping through programmatic access. Supports multi-currency transactions, tax calculations, and attachment management on all document types.
Install Jentic One Beta
Connect the Xero Accounting API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Xero Accounting API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fxero.com%2Fxero-accounting" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fxero.com%2Fxero-accounting" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Xero Accounting API.
Generate and send invoices with line items, tax rates, and payment terms to contacts
Reconcile bank transactions against outstanding invoices and bills automatically
Record payments, credit notes, and overpayments against specific invoices
Pull profit-and-loss, balance sheet, and aged receivables reports on demand
Sync contacts with full address, tax registration, and payment history details
Track multi-currency transactions with automatic exchange rate conversion
Attach source documents (receipts, contracts) to any transaction or contact record
Use Cases
Patterns agents use Xero Accounting API for, with concrete tasks.
★ AI Agent Invoice Automation
AI agents use the Xero Accounting API through Jentic to create invoices, apply payments, and check outstanding balances without building custom OAuth flows or handling token refresh. The agent searches for the operation (e.g., 'create an invoice'), Jentic returns the schema for the /Invoices endpoint with required fields, and the agent executes. Jentic manages OAuth2 tokens and tenant ID headers, so the agent never handles raw credentials.
Create a new sales invoice for contact 'Acme Corp' with two line items totalling $1,250 NZD, set payment due in 30 days, then confirm the invoice status is AUTHORISED
Bank Reconciliation
Reconcile bank statement lines against outstanding invoices and bills in Xero. The API supports creating bank transactions, matching them to existing records, and flagging discrepancies. Batch endpoints allow processing multiple transactions in a single call, with support for bank feeds that push statement data directly into Xero for matching.
Retrieve all unreconciled bank transactions from the last 7 days, match each against outstanding invoices by amount, and create bank transaction records for confirmed matches
Financial Reporting
Generate profit-and-loss statements, balance sheets, aged receivables, and aged payables reports via API. Reports accept date range parameters and can be filtered by tracking category. The trial balance endpoint provides account-level debit and credit totals for any period, enabling custom reporting and data warehousing workflows.
Pull the profit-and-loss report for Q1 2026 and return total revenue, total expenses, and net profit figures
Contact and Supplier Management
Store and query contact records including customers, suppliers, and employees. Each contact holds billing address, tax number, payment terms, and full transaction history. The API supports batch creation of contacts and filtering by name, email, or account number, enabling CRM synchronisation workflows.
Search for all contacts with outstanding invoices over 60 days overdue and return their names, email addresses, and total amounts owed
Key Endpoints
237 endpoints — record and reconcile financial transactions, generate invoices, track payments, and produce financial reports for small and medium businesses.
METHOD
PATH
DESCRIPTION
GET
/Invoices
List all invoices with optional status and date filters
POST
/Invoices
Create one or more new invoices
GET
/Contacts
List all contacts (customers and suppliers)
POST
/Payments
Record a payment against an invoice or bill
GET
/BankTransactions
List bank transactions for reconciliation
GET
/Accounts
Retrieve the chart of accounts
GET
/Reports/ProfitAndLoss
Generate a profit and loss report
GET
/Reports/BalanceSheet
Generate a balance sheet report
GET
/Invoices
List all invoices with optional status and date filters
POST
/Invoices
Create one or more new invoices
GET
/Contacts
List all contacts (customers and suppliers)
POST
/Payments
Record a payment against an invoice or bill
GET
/BankTransactions
List bank transactions for reconciliation
GET
/Accounts
Retrieve the chart of accounts
GET
/Reports/ProfitAndLoss
Generate a profit and loss report
GET
/Reports/BalanceSheet
Generate a balance sheet report
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
X
Xero Accounting API
- Foundational (C)57/100
68
Foundational Compliance57
Developer Experience & Jentic Compatibility54
AI-Readiness & Agent Experience43
Agent Usability90
Security58
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
68
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: B+Signals: 4
71%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
0%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
57
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: C+Signals: 4
32%
Example Density
How richly the API is illustrated with examples.
61%
Example Validity
Percentage of examples that conform to their schemas.
36%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
54
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: CSignals: 4
56%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
62%
Summary Coverage
Coverage of summaries across operations/tags/info.
43
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: D-Signals: 1
43%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
90
Security
Trust, risk posture, and security compliance.
Grade: A+Signals: 1
90%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
58
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: C+Signals: 1
58%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Xero Accounting API by hand means implementing its OAuth2 flow, sending the correct tenant header on every request, and mapping 237 operations across invoices, contacts, and reports yourself. Through Jentic you install once, import the Xero Accounting API from the API Directory, store the OAuth2 credential once, and your agent calls it.
Permission scoping
The Xero Accounting API identifies its collections through the operation and request body rather than a resource id in these URL paths, so scope by operation: limit the agent to the operations it needs, such as reading invoices or a profit-and-loss report. You choose that set, so writes like posting invoices or payments are not included unless you add them.
Credential isolation
Your Xero Accounting OAuth2 credential and tenant id are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create an invoice' or 'get the balance sheet report', and Jentic returns the matching Xero Accounting API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Xero Accounting API through Jentic.
What authentication does the Xero Accounting API use?
Xero uses OAuth 2.0 with PKCE for all API access. Applications must obtain an access token through the authorization code flow and include a xero-tenant-id header identifying the target organisation. Through Jentic, OAuth tokens are stored in your Jentic One instance with automatic refresh - agents never handle client secrets or manual token rotation.
Can I create and send invoices with the Xero Accounting API?
Yes. POST to /Invoices with a contact reference, line items, and tax rates to create an invoice. Set the Status field to AUTHORISED to approve it, then use the email endpoint to deliver it. The API supports batch creation of up to 50 invoices in a single request.
What are the rate limits for the Xero Accounting API?
Xero enforces a limit of 60 calls per minute per tenant (organisation) and 5,000 calls per day per tenant. Batch endpoints that accept multiple records in one call count as a single request. The API returns a 429 status with a Retry-After header when limits are exceeded.
How do I generate financial reports through the Xero API via Jentic?
Search Jentic for 'generate profit and loss report', then load the /Reports/ProfitAndLoss operation schema. Provide fromDate and toDate parameters, and the agent receives a structured report with income, expense, and net profit figures. Install with pip install jentic or run it through Jentic One, the self-hosted execution layer.
Does the Xero Accounting API support multi-currency transactions?
Yes. Invoices, payments, and bank transactions can be recorded in any currency enabled in the organisation's settings. The API applies the exchange rate from Xero's daily feed or accepts a custom rate on each transaction. The /Currencies endpoint lists all enabled currencies and their current rates.
Can I reconcile bank transactions programmatically with Xero?
Yes. The /BankTransactions endpoint allows creating spend and receive money transactions. Bank feed integrations push statement lines into Xero, and the /BankTransfers endpoint records transfers between accounts. For automated matching, pull unreconciled lines and compare against outstanding invoices by amount and date.
Can I limit what my agent is allowed to do with the Xero Accounting API?
Yes. Because you run Jentic One yourself, your own rules decide which Xero Accounting operations the agent may call, so you can scope it to read-only work like listing invoices on /Invoices or pulling a /Reports/ProfitAndLoss report. Write operations such as posting to /Invoices or recording /Payments stay out of reach unless you explicitly add them to the allowed set. Your OAuth2 credential and tenant id are held only by your own instance and injected at execution time, so the agent can act only within the operations you have granted.
GET STARTED