Okapi Okapi

Xero API /api.xro/2.0/Receipts* endpoint removal

Deprecated, no dateSubscribe to Xero APIShare

The Receipts endpoint has been deprecated without a shutdown date. This deprecation affects all calls matching /api.xro/2.0/Receipts*, which will ultimately fail. Xero API announced on July 31, 2025, that it is deprecating the endpoint.


Calls it hits

  • /api.xro/2.0/Receipts*

What to use instead of these calls

Stop creating draft expense claim receipts and instead record spend using PUT /api.xro/2.0/BankTransactions or bills via PUT /api.xro/2.0/Invoices with Type ACCPAY. This move requires more than changing an identifier, as receipts belong to the retiring Classic Expenses product and switching alters how expenses are recorded.

Receipts belong to the retiring Classic Expenses product; moving to bills or bank transactions changes how expenses are recorded.

In Xero API's words

We will also be deprecating the Receipts endpoint.

Xero API, Announcement

Facts

API
Xero API api.xero.com
Kind
Endpoint removal
Announced
July 31, 2025
Takes effect
No date given yet
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against Xero API's own pages

Questions

When does this change take effect?

Xero API deprecated /api.xro/2.0/Receipts* without giving a shutdown date yet.

Do these calls still work?

Yes, they still work: Xero API has not given a shutdown date yet.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from Xero API 8

  1. GET /finance.xro/1.0/AccountingActivities/*Removal Stopped working
  2. /practicemanager/3.1/lead.api/*Removal Stopped working
  3. /practicemanager/3.0/purchaseorder.api/*Removal Stopped working
  4. /practicemanager/3.1/supplier.api/*Removal Stopped working
  5. POST /payroll.xro/1.0/PayItemsBehaviour change Stopped working
  6. POST /payroll.xro/2.0/employees/{id}/taxBehaviour change Stops workingin 27 days
  7. /api.xro/2.0/ExpenseClaims*Endpoint removal Stops workingin 87 days
  8. /practicemanager/3.0/*Version retirement Stops workingin 181 days

Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix.

Add to GitHub

Get notifications

Subscribe to Xero API

Hear about each breaking change Xero API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Xero API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.