Item resource

An item represents a connection to a bank account using a set of user credentials.
It contains one or more accounts which contain transactions.

LIST OF ITEM STATUS CODES

{
  "id": 187741,
  "resource_uri": "/v2/items/187741",
  "resource_type": "item",
  "status": 1003,
  "status_code_info": "BANK_IS_DOWN",
  "status_code_description": "Your bank's interface is down for now.",
  "bank": {
    "id": 408,
    "resource_uri": "/v2/banks/408",
    "resource_type": "bank"
  },
  "accounts": [
    {
      "id": 2341488,
      "resource_uri": "/v2/accounts/2341488",
      "resource_type": "account"
    }
  ],
}

PROCESS OF REFRESHING AN ITEM ON DEMAND

Note that all items except those needing Strong Customer Authentication for each connection will be refreshed automatically twice a day by Bridge. You may want to refresh an item on demand, in which case you can use one of these two following processes:

WITH THE BRIDGE CONNECT

Call the Manage SCA and Sync endpoint

WITHOUT THE BRIDGE CONNECT (only for items without SCA)

Call the Refresh an item endpoint for the given item.
Check periodically (every 5 seconds) the item's status by calling GET /v2/items/:id/status

• If status is info_required, this item needs an SCA
• If status is invalid_creds, the user credentials are incorrect. Edit the credentials and start again at step 1.
• If status is authenticating, the item is trying to establish a connection. Keep checking the status.
• If status is retrieving_data, the item is retrieving the data and indicates its progression.
• If status is finished, the item retrieved all its data.
• If status is finished_error, something went wrong. Check the item's status by calling GET /v2/items/:id and check the Items status page.