---
title: "List instruments for a client"
method: GET
path: "/v1/clients/{clientId}/instruments"
---

# List instruments for a client

`GET /v1/clients/{clientId}/instruments`

Returns a paginated list of instruments belonging to the specified client and its customers.
- Without `customer_id`, it returns instruments for the client and all associated customers.
- With `customer_id`, it returns only instruments for that customer.

## Path parameters

- `clientId` string, uuid, required

## Query parameters

- `customer_id` string, uuid
- `page` integer
- `per_page` integer

## Response `200`

List of instruments for the client (and optionally a specific customer).

- InstrumentsResponse
  - `data` InstrumentResponse[], required
    - `id` string, required
    - `bankId` string, required
    - `clientId` string, required
    - `ownerId` string, required — Identifier of the entity that owns this instrument (client or customer). When the instrument belongs to a customer, `ownerId` and `customerId` will be the same.
    - `alias` string, required
    - `type` 'RECEIVER', required
    - `audit` object, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `blockedAt` string, nullable, required
    - `rfc` string, required
    - `customerId` string — Customer who owns the instrument when applicable. Present when the instrument belongs to a customer; omitted for client-level instruments.
    - `instrumentDetail` union, required
      - CardInstrumentDetail
        - `cardNumber` string, required
        - `expirationDate` string, nullable — May be the string "None" or null when not available.
        - `holderName` string, required
      - ClabeInstrumentDetail
        - `accountNumber` string, required
        - `clabeNumber` string, required
        - `holderName` string, required
  - `currentPage` integer, required
  - `perPage` integer, required
  - `totalItems` integer, required

## Other responses

- `400` — Client not found (DATA_ERROR - "No client found for id: ...").
- `404` — Customer not found or not associated to this client (RESOURCE_NOT_FOUND - "Customer not found").

---

[API](https://skmtc.net/monato/apis/fincore-api.md) · [All operations](https://skmtc.net/monato/apis/fincore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/fincore-api/revisions/a8263ed74545/schema)