# Release History
source: https://developer.mastercard.com/open-finance-data/documentation/release-notes/index.md
Notable changes to the Open Finance Data documentation are listed below (in reverse chronological order).
| **Date** | **Description** |
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 2 April 2026 | **Data Refresh APIs:** Removed the endpoints for On Demand Data Refresh: * Schedule a data refresh job * Get status of a refresh job |
| 27 January 2026 | **Get Transactions API:** Added the following new fields: * `transaction->additionalInformation[EU]->ultimateDebtor` * `transaction->additionalInformation[EU]->ultimateCreditor` * `transaction->additionalInformation[EU]->currencyConversion->targetCurrency` * `transaction->additionalInformation[EU]->currencyConversion->quotationDate`
**Get Accounts API:** Added deprecation notice to account-\>providerName field. This field will be removed in the future version. |
| 13 November 2025 | **General:** * Removed redundant documentation now included in the developer portal. * Removed servers that are not yet supported. * Added examples for all responses and corrected existing error examples. * Applied default YAML formatting (prettier). **Delete Account API:** Changed the HTTP status code for the delete account endpoint from 200 to 204. **Get Accounts API:** * Removed non-existent currency fields from the account's required fields. * Moved `account->displayAccountNumber` to `account->additionalInformation[US]->displayAccountNumber`. * Added additional enum values to `account->holders[EU]->relationship`. * Removed `account->holders[*]->person->documentations`. **Get Transactions API:** * Removed transaction-\>clearedAt. * Removed transaction-\>providerCreatedAt. * Expanded the description of the transaction-\>date field. Added the following new fields: * * `transaction->additionalInformation[EU]->bookingDate` * `transaction->additionalInformation[EU]->bankTransactionCode` * `transaction->additionalInformation[EU]->proprietaryBankTransactionCode` * `transaction->additionalInformation[EU]->source->card` Updated the type of `transaction->additionalInformation[EU]->valueDate` to support both `date` and `dateTime`. |
| 7 October 2025 | **Get Accounts API:** Added `account->refresh->lastTransactionDataRefreshedAt` field. **Schedule a Data Refresh Job API:** Added new endpoint for On Demand Data Refresh: Schedule a data refresh job. **Get Status of a Refresh Job API:** Added new endpoint for On Demand Data Refresh: Get status of a refresh job. |
| 18 September 2025 | **Get Accounts API:** Made region field mandatory across account entities. **Get Transactions API:** Made region field mandatory across transaction entities. |
| 2 September 2025 | **General:** Changed base context path from `/financial-dat`a to `/data`. |
| 21 July 2025 | **General:** * Changed provider identifier format to uuid. * Changed base context path from `/financial-data` to `/data`. |
| 10 July 2025 | **Get Accounts API:** Made the following fields optional: * `account->holders[*]->person->fullName` * `account->holders[AU, US]->type` * `account->holders[AU]->addresses` Made the following fields mandatory: * `account->balances[]->amount` * `account->balances[]->currency` * `account->balances[]->balanceType->type` Introduced validation to ensure the `account->holders[]/emails[]/email` field conforms to the email format. Removed minLength and maxLength attributes from the following fields: * `account->currencies[]` * `account->balances[]->currency` * `account->balances[]->creditLines[]->currency` **Get Transactions API:** Made the following fields optional: * `transaction->balance->amount` * `transaction->balance->currency` * `transaction->balance->lastRefreshedAt` Made the following fields mandatory: * `transaction->type` * `transaction->status` * `transaction->amount` * `transaction->currency` Removed the double format specification from the transaction-\>amount field. Removed the `transaction->additionalInformation[EU]/currencyConversion/originalAmount` field. Removed `minLength` and `maxLength` attributes from the following fields: * `transaction->currency` * `transaction->balance->currency` |
| 24 June 2025 | **Get Transactions API:** * Removed `transaction->text`. * Removed `transaction->providerText`. * Added `transaction->description` as replacement of `transaction->text`. * Added `transaction->additionalInformation->informationFromProvider`. * Updated the filter request query parameter to include details about using the date field, which must always be provided with time resolution. * Added HTTP 400 BadRequest response to GetTransactions endpoint for cases where filter or sorting parameters are invalid. * Removed `transaction->lastUpdatedAt`. * Renamed `transaction->balance->lastUpdatedAt` to `transaction->balance->providerLastUpdatedAt`.
**Get Accounts API:** * Removed `account->lastUpdatedAt`. * Removed `account->holders[EU]->lastUpdatedAt`. * Renamed `account->holders[AU, US]->lastUpdatedAt to account->holders[AU, US]->providerLastUpdatedAt`. * Renamed `account->balances[]->lastUpdatedA`t to `account->balances[]->providerLastUpdatedAt`.
**General:** Removed DPoP header from request on all endpoints, this will be covered later as part of separate AuthNZ section. |
| 9 June 2025 | **General:** * Improved the Introduction section of the API description. * Removed the BadRequest response type where it was not applicable. * Removed the NotFound response type where it was not applicable. * Added the Unauthorized response type where needed. * Added `minimum`, `maximum`, `minLength`, and `maxLength` validations to the relevant schema elements. * Corrected spelling errors.
**Get Accounts API:** Added `creditLines` object under the `Account->Balance` element. |
| 30 May 2025 | **General:** * Incremented version to 1.0.0. * Improved documentation throughout. * Changed X-Correlation-Id header to accept free format (previously only UUID). * Specified UUID format for all internal identifiers.
**Get Providers API / Get Provider Groups API:** * Moved Providers endpoint to a separate contract specification. * Added total field to all paginated responses.
**Get Accounts API:** * Added total field to paginated responses. * Updated cardinality (mandatory/optional) for elements in the `Account` object. * Moved `providerAccountId`, `providerStatus`, and `providerProduct` to the root. * Renamed `account->detail`s to `account->additionalInformation`; updated the include filter parameter accordingly. * Renamed `account->status->INACTIVE` to `account->status->SHADOW` and updated the description. * Renamed `account->details->subType` to `account->additionalInformation->subType->type`. * Added `account->additionalInformation->subType->providerValue`. * Added `lastRefreshedAt` under the AccountHolder parent. * Added prefix and documentation under the HolderPerson parent. * Added extension under the Phone parent. * Added description under the `HolderAddress` parent. * Extended the list of types in `HolderAddress->type`. * Renamed `account->balance->type` to `account->balance->balanceType->type`. * Added `account->balance->balanceType->providerValue`. * Extended the list of types in `Balance->type`. * Updated Account-\>Identifiers description for supported types.
**Get Transactions API:** * Added total field to paginated responses. * Updated cardinality (mandatory/optional) for elements in the `Transaction` object. * Removed `accountId` field. * Updated description of transaction-\>status for possible statuses. * Renamed `transaction->details` to `transaction->additionalInformation`; updated the include filter parameter accordingly. * Added `merchantDetails`, `remittanceInformationUnstructured`, `remittanceInformationStructured`, identifier, source, and destination structures under `transaction->additionalInformation`. |