When recovering items a list of products is returned depending on the connector's category. Currently, we are supporting full banking data, so a list of accounts, credit cards, identity, and investments are provided.

  "accounts": [{}],
  "investments": [{}],
  "identity": {}


An Item represents the link between a User and an Institution that will be using our Connectors to access their data and sync that item daily. It could be a bank account, a fintech app user, or any other supported connector.

An Item contains a set of parameters or credentials that are needed to execute the synchronization with the institution. These credentials are encrypted and can never be retrieved from the API.

An item can configure its webhooks notifications to recover all events related to that specific item, providing a valid URL in the webhookUrl parameter. For more information review the Webhook section.

Item Status

To understand the current status of an item we must review his status field for a first overview of the connection’s health.





The connection is syncing with the provider.

An update process is in progress and will be updated soon.


The connection is syncing with the provider.

The connection must be updated to execute again, it won't trigger updates until the parameters are updated.


The sync process finished with errors.

The parameters were correctly validated but there was an error in the last execution. It can be retried.


The sync process needs user's input to continue.

The connection requires user's input to continue the sync process, this is common for MFA authentication connectors.


The sync process finished successfully.

The last sync process has completed successfully and all new data is available to collect.

As mentioned above when we trigger an update the connection will be indicating UPDATING as its status. This is an in-progress status and that means you will have to recheck in a couple of seconds.

If the credentials sent were invalid, you will encounter a LOGIN_ERROR status and will be required to update it.

In case there was an error you will encounter the OUTDATED status, and you will have to review the executionStatus for further details.

And the most common scenario you will see the UPDATED status, which means that the connection was successfully synced with the institution.

Execution Status

As we mentioned the sync process has a status that indicates the step or states the execution is at. Some of the statuses mark the progress or step it's in, and others mark the status or state the execution ended.




The execution was completed successfully.


The execution was completed successfully, but there are some products that weren't collected.


There was an unexpected error in the connection.


The connection couldn't access the institution due to invalid submitted credentials.


The connection couldn't be established right now because there is an active session.


The connector didn't get a response from the institution you are trying to connect.


The connection was successfully initiated.


The connection needs the user's input to continue the execution.


The connection couldn't be established due to invalid multi-factor authentification.


The connection couldn't access the institution because the user's account has been locked.


The connection couldn't be established right now because user action is needed.


The connection couldn't access the institution because there was a connection error


See Items in our API reference for more information.