Operational Rate Limits

Open Finance Rate Limits

There are two types of rate limits Pluggy's to recover the data, and Open Finance Operational Rate limit from the financial institutions.

The Brazilian Open Finance Network imposes rate limits on the number of times per month that anyone using Open Finance can fetch each product. This limitation is not from Pluggy; it's the limitation to synchronize Pluggy's data.
These limits apply per combination of CPF/CNPJ, institution, and product (i.e., card, account, investment, or loan).

📘

Pluggy manages rate limits, so you don't have to worry about it.

Under normal usage of Open Finance Connectors (one CPF and institution on only one item), you won't have to worry about Rate Limits, since you would never reach them even if you had automatic updates enabled on all your items updating up to 4 times per day.

❗️

Creating mutliple items for the same CPF/CNPJ + Institution

However, keep in mind that if you connect the same CPF/CNPJ to the same institution by creating multiple items, you will reach the limitation of Open Finance faster, meaning that some products won't be updating/returning their data until the limit is renewed on the next month.
When not using an item, trigger the deletion of it to avoid syncing automatically.

Accounts (Checking and Savings)

ProductMonthly requests allowedMoments we fetch this product
Account list & details4Item creation and every 7 days
Account balance420Every update *
Recent transactions (1 to 6 days ago)240Every update *
Non-recent transactions (7 to 365 days ago)4Item creation and every 7 days

* Every Update means that each execution the item does.

Considerations

  • After 240 requests, new transactions won't appear until the next month.
  • After 420 requests, the account's balance won't be updated until the next month.
  • On every update, both requests are consumed, and currently, it's not supported to just recover the balance. If needed, create a connection that would only recover the ACCOUNTS product, sending in the products array the desired product.

Credit Cards

ProductMonthly requests allowedMoments we fetch this product
Credit card list & details4Item creation and every 7 days
Credit card bills & bill transactions30Item creation and once per day
Credit card limits240Every update *
Recent transactions (1 to 6 days ago)240Every update *
Non-recent transactions (7 to 365 days ago)4Item creation and every 7 days

* Every Update means that each execution the item does.

Considerations

  • If a new credit card appeared as authorized, it could take up to 7 days to appear in the responses.
  • Credit card bill transactions (closed and past bills) will be updated daily.
  • Credit card limits and new transactions will be synced on every update.
    • After 240 updates, this has an average of 8 updates per day. It will hit the rate limits and won't update transactions until the next month.

Investments

ProductMonthly requests allowedMoments we fetch this product
Investment list30Item creation and once per day
Investment detail4Item creation and every 7 days
Investment balance120Every update *
Investment Transactions (Recent - 1 to 6 days ago)120Every update *
Investment Transactions (History - 7 to 365 days ago)4Item creation and on demand.

* Every Update means that each execution the item does.

Considerations

  • If an item it's updated 120 times before the end of the month, new transactions nor balances won't be synced until the 1st of the next month.
  • Details recover the asset's rate, rateType, fixedAnnualRate, etc. This information shouldn't change, and it's recovered on creation. If there is a change for some reason, it will be reflected after 7 days from that update.
  • If a new investment was acquired, but the rate limit was already achieved, it won't appear until the next month.

Other products

ProductMonthly requests allowedMoments we fetch this product
Identity4Item creation and every 7 days
Loans List & Detail4Item creation and every 7 days
Loans Instalments30Item creation and once per day
Loans Payments30Item creation and once per day
  • Loans will be updated daily, if an item is updated more than once per day, it won't sync loan's data.
  • Identity information is recovered on item creation and will sync updates every 7 days. If there is any personal data updated, won't reflect changes until it executes a sync after 7 days from the initial sync.

Understanding an item that reached the rate limit


How is the rate limit returned as a warning?

When a rate limit is reached, you will see the Item in status PARTIAL_SUCCESS and inside the status detail, a warning about the failing product:

{
  "id": "44534b0e-717e-497d-890f-08c2faa468c1",
  "status": "PARTIAL_SUCCESS",
  "statusDetail": {
    "accounts": {
      "warnings": [
        {
          "code": "423",
          "message": "Open Finance monthly rate limit reached on product 'accounts' for this CPF/CNPJ and institution. The product could not be updated."
        }
      ],
      "isUpdated": false,
      "lastUpdatedAt": "2023-10-19T19:19:58.188Z"
    },
  },
  ...
}