Upcoming Change to Recharge API - 90-day Lookback Limit for Processed Charges
Starting March 19th, 2025, we’re making changes to our retrieve, and list charge endpoints on API versions 2021-01 and 2021-11. Success, refunded, or partially- refunded processed charges over 90 days ago will no longer appear in the results. Please review your integration accordingly.
In 2025, Recharge is thrilled to improve our speed, scalability, and data analysis capabilities for your store. These enhancements will lead to more robust features and faster API and page load times.
What You Need to Do
Please review your API integration for any impacts and update your API calls, if necessary, that fetch charges with a processed_at date older than 90 days (whether fetching an individual charge or a list of charges).
Please note:
- GET requests will only return charges processed within the last 90 days. Otherwise, it will result in an empty list.
Charge data processed over 90 days ago will remain available through the Exports tool in your Recharge merchant portal and within the Merchant portal UI.
Examples of unaffected API calls:
- [LIST CHARGES]
/charges?status=queued
- [LIST CHARGES]
/charges?status=error
- [RETRIEVE A CHARGE]
/charges/{id}
(if it's a charge that does not have a processed_at date or the processed_at date is within the last 90 days)
Examples of API calls that may return partial results:
- [LIST CHARGES]
/charges?processed_at_min=2024-01-01
(this would only return results that have a processed_at date in the last 90 days) - [LIST CHARGES]
/charges?status=success, queued
(this would return all queued charges but only return success charges that have a processed_at date in the last 90 days) - [LIST CHARGES]
/charges?ids={id},{id},{id}
(this would only return charges that do not have a processed_at date or the processed_at date is within the last 90 days)
Examples of API calls that will result in an empty list:
- [LIST CHARGES]
/charges?processed_at_max=2024-01-01
(any date over 90 days old)
Example of API calls that will result in a 404:
- [RETRIEVE A CHARGE]
/charge/{id}
(if it's a charge with a processed_at date older than 90 days)