Returns a list containing the accounts shared for a consent.
Does a fresh pull from the external provider.
URL https://www.atto.co/about/contact
API Support support@atto.co
License All Rights Reserved © The IDCO. Ltd
Terms of Service
The above endpoint has been split into the following:
/data/v2/consents/{consentId}/accounts (Returns a list containing all accounts shared for a consent)
/data/v2/consents/{consentId}/accounts/{accountId} (Returns a specific account shared for a consent)
/data/v2/consents/{consentId}/accounts/{accountId}/balances (Returns the balance information for a specific account)
/data/v2/consents/{consentId}/accounts/{accountId}/transactions (Returns a list of transactions tied to a specific account. The data returned by this endpoint is paginated and subsequent calls using the links provided in response body may be required to retrieve the full data set)
It's important to note that when trying to fetch 3 months or more worth of data OR if the account has lots of transactions, it is best to use the paginated endpoint for this owing to the large volume of data involved.
The transaction data returned via this endpoint has a sliding date window which is dependent upon the time of connection and the configured days of historical transactions. For instance, if the user connected their account on the 15th of the Month, and the client has been configured to return the last 10 days of transactions, the transactions fetched will be from the 5th to the 15th. If this data is requested 2 days later from the time of initial connection (15th), i.e. on the 17th this will return the transactions from the 7th to the 17th.
We have added a links component to our responses to easily paginate through large volumes of data. The next and prev links represent relative uris. You can append our baseUrl to get the next or prev set of data if available as indicated below:
"links": {
"prev": "/relativeUri/for_previous_page",
"next": "/relativeUri/for_next_page"
}Please note for the UK Banks the SCA rules apply as well in addition to the sliding date range, the maximum allowed date range is last 90 days after the SCA expiry.
For Data retention see our Bank Data Stored API.
curl -i -X GET \
'https://uk.api.atto.co/data/v2/consents/{consentId}/accounts' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'endUser-Ip: string'{ "data": { "providerId": "string", "providerName": "string", "countryCode": "string", "requestDateTime": "string", "accounts": [ … ] }, "meta": { "totalRecords": 0 } }