UPCOMING API CHANGES | v3 bills for international vendors
On December 4, 2025, we will release a fix in the v3 bills response to correctly show the fundingAmount and amount information for international vendors (outside US). You are receiving this email because you are a BILL API user and you currently have bills created for international vendors in the production environment.
v3 bills for international vendors
When you create a bill with POST /v3/bills for an international vendor, the API response correctly shows the fundingAmount and amount information.
| Field | Description |
|---|---|
fundingAmount | Bill total amount. This value is in USD. |
amount | Bill total amount. For a bill in an international currency (not USD), this value is in the international currency. |
We learned that when you get bill details (with GET /v3/bills or GET /v3/bills/{billId}), the fundingAmount and amount field values were not correctly displayed.
NOTEThis issue occurs only in bills created for an international vendor (outside US). Any bill created for a US vendor is not affected.
On December 4, 2025, we will release a fix for the GET /v3/bills and GET /v3/bills/{billId} API endpoints to correctly display the fundingAmount and amount field values for bills created for international vendors.
Developer actions
In your integrations, if you get bill details with GET /v3/bills or GET /v3/bills/{billId}, make sure that the fundingAmount and amount information is correctly displayed for bills created for your international vendors.