Changes to the API
Track changes and upgrades to the Fintoc API
Up until now, every change to the Fintoc API has been backwards compatible. Whenever we make a change that is not backwards compatible, we will release a new version of the API to prevent your code from breaking.
Backwards compatible changes
Fintoc considers the following changes as backwards compatible:
- Add objects to the API.
- Add optional parameters to already existing API endpoints.
- Add new fields to existing objects.
- Change the order of the keys in an object.
- Change the length or format of the IDs and tokens. This includes adding or removing prefixes (like the
acc_
prefix on the ID of the Account Object). - Change header's field names to uppercase or lowercase. According to RFC7230, header field names are case-insensitive. Note that field values are case-sensitive.
You shouldn't assume the format of IDs nor tokens
You should never parse an ID or a token to get information out of it. Changes to these fields are considered backwards compatible, so the format can change at any moment.
API Changelog
2021-05-19
- The
pending
field was added to the Movement Object to denote movements that could still be reverted by the bank. - The
status
field was added to the Link Object that indicates whether it is necessary for the user to reconnect theLink
or not.
2021-05-05
-
The
object
field was added to every object returned by the API. That way, whenever you get a response body from the API, you can know the object type from theobject
field. -
A prefix was added to every ID from the API. That way, whenever you see an ID you can know to which object type it corresponds.
What about old IDs?
Old IDs don't change, you can expect to continue seeing them like before the change. Only objects created after
2021-05-05
have the new ID format.
2020-11-17
- The
refreshed_at
field was added to the Account Object.
2020-10-12
- The
per_page
field was added to the List Movements Endpoint.
2020-08-25
- The
reference_id
field was added to the Movement Object.
2020-06-22
- The
holder_name
field was added to the Movement Object.
2020-06-15
- The
mode
field was added to the Link Object.
2020-06-02
- The
sender_account
,recipient_account
andcomment
fields were added to the Movement Object.
Updated about 1 year ago