---
title: "Get Linked Accounts for User"
method: GET
path: "/api/v1/users/:userId/linked-accounts"
tags: ["LinkedAccounts"]
---

# Get Linked Accounts for User

`GET /api/v1/users/:userId/linked-accounts`

## Request

- Base URL: `https://merchant-api.accruesavings.com`
- URL: `https://merchant-api.accruesavings.com/api/v1/users/:userId/linked-accounts`
- Auth: none declared. Required headers: `Client-ID`, `Authorization`
- TypeScript: <https://skmtc.dev/byaccrue/apis/accrue-merchant-api/docs/api/v1/users/:userId/linked-accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves all linked bank accounts for a specific user. These accounts can be used for funding payments by providing the linkedAccountId when creating a payment.

## Path parameters

- `userId` string, uuid, required: The ID of the user whose linked accounts to retrieve.

## Headers

- `Client-ID` string, uuid, required: The unique identifier of the client making the request. This header is required to retrieve the client-specific configuration and ensure that the response is tailored to the client's settings and permissions.
- `Authorization` string, uuid, required: Secure secret to access privileged endpoints.

## Response `200`

OK

- GetLinkedAccountsResponse
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier for the object.
    - `type` 'LinkedAccount', required
    - `attributes` object, required
      - `provider` 'Meld' | 'Plaid' | 'Checkout': The provider used to link the bank account.
      - `status` 'Connected' | 'Disconnected' | 'Pending': The current status of the linked account.
      - `accountType` 'checking' | 'savings' | 'debit' | 'creditCard' | 'fundingCreditCard' | 'pending': The type of the linked account.
      - `accountName` string: The name of the account as provided by the institution.
      - `accountMask` string: The masked account number (typically last 4 digits).
      - `institutionName` string: The name of the financial institution.
      - `institutionId` string: The unique identifier for the institution.
      - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required

## Other responses

- `400`: Bad Request. The user has no wallet with your account.
- `404`: Not Found. The user does not exist.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/byaccrue/apis/accrue-merchant-api.md) - [All operations](https://skmtc.dev/byaccrue/apis/accrue-merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/byaccrue/apis/accrue-merchant-api/revisions/3e2d97ef2e6e?raw)