Skip to main content
GET
List funding sources

Authorizations

Authorization
string
header
required

User bearer credential: either a Cognito JWT or an ak_ user API key. Backend integrators using HMAC must include the user API key alongside the three HMAC headers on user-scoped endpoints.

Response

Response for status 200

id
string
required

Opaque public identifier for the funding source

Example:

"fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X"

bankAccountId
string
required

Underlying bank account identifier

Example:

"ba_abc123"

institutionName
string | null
required

Institution name used for funding source display. Prefer institution.name when present; this field will be removed in a future release.

Example:

"Plaid Test Bank"

institution
object | null
required

Branding metadata for the institution backing the funding source, or null when no institution data is available.

accountNumberLast4
string | null
required

Last 4 digits of the linked bank account number

Example:

"6789"

accountType
enum<string>
required
Available options:
checking,
savings,
business,
unknown
status
enum<string>
required
Available options:
pending,
active,
review_required,
ineligible,
disabled,
deleted
statusReason
enum<string> | null
required

Why the funding source is not active, or null when no reason applies.

Available options:
ownership_mismatch,
ownership_review_required,
user_not_verified,
duplicate_bank_account,
returned,
risk_blocked,
rerouted,
manually_disabled,
null
Example:

"ownership_mismatch"

availableAt
string<date-time> | null
required

For a time-boxed block (statusReason: rerouted), when the funding source becomes usable again on its own. Re-linking the same account does not shorten it. Null when the source is usable or the block is not time-bound.

Example:

"2026-09-18T15:04:05.000Z"

permanent
boolean
required

True when the funding source is disabled and will not become usable again on its own; the user should link a different bank account.

deletedAt
string<date-time> | null
required

When the funding source was removed by the user, or null while it remains linked. Removed funding sources stay retrievable by id for historical reference.

Example:

null

createdAt
string<date-time>
required

When the funding source was created