Skip to main content
A bank consent lasts as long as the bank allows, and then it has to be renewed by the person. Didit tells you before it ends and gives you a renew call for the same connection.

How long it lasts

  • The bank and the route set the end date, at most the consent_days you asked for.
  • Every connection shows its real dates in consent.expires_at and consent.renew_by.
  • The institution shows the longest consent the bank allows in consent_days_max.
  • Never promise your users a fixed number of days: say “until” the date on the connection.

Know in advance

bank.connection.consent_expiring is sent 14, 7 and 1 day before the end. You can also list connections that end soon:

Renew

It answers 201 with a renew link, or one of these: The page where the person completes a renewal is not available yet, so do not send people to a renew link today. Until it is, use the reminders above to know when a consent ends.
  • The connection becomes renewal_required with status_reason: consent_expired or bank_requires_sign_in.
  • You can still read what was synced, nothing is synced or charged, and bank.connection.renewal_required is sent.
  • After consent.renewable_until it is revoked with status_reason: consent_lapsed, and the person connects again.
Last modified on November 22, 2026