---
title: "Refresh a user's bank income information"
method: POST
path: "/credit/bank_income/refresh"
tags: ["plaid"]
deprecated: true
---

# Refresh a user's bank income information

`POST /credit/bank_income/refresh`

> **Deprecated.**

`/credit/bank_income/refresh` is deprecated. The backend implementation was removed (returns an `Unimplemented` error at runtime), and the endpoint is no longer part of the documented API surface. To refresh Bank Income data for an existing user, send the user through Link's update mode so they can confirm their income sources. For a fully backend refresh, migrate to CRA Income Insights and call `/cra/check_report/create`.

## Request body

- CreditBankIncomeRefreshRequest — CreditBankIncomeRefreshRequest defines the request schema for `/credit/bank_income/refresh`.
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `user_token` string, required — The user token associated with the user for which data is being requested. This field is used only by customers with pre-existing integrations that already use the `user_token` field. All other customers should use the `user_id` instead. For more details, see [New User APIs](https://plaid.com/docs/api/users/user-apis).
  - `user_id` string — A unique user identifier, created by `/user/create`. Integrations that began using `/user/create` after December 10, 2025 use this field to identify a user instead of the `user_token`. For more details, see [New User APIs](https://plaid.com/docs/api/users/user-apis).
  - `options` CreditBankIncomeRefreshRequestOptions — An optional object for `/credit/bank_income/refresh` request options.
    - `days_requested` integer — How many days of data to include in the refresh. If not specified, this will default to the days requested in the most recently generated bank income report for the user.

## Response `200`

OK

- CreditBankIncomeRefreshResponse — CreditBankIncomeRefreshResponse defines the response schema for `/credit/bank_income/refresh`.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)