Instruments

List instruments for a client

Changed on Sep 26, 2026

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.

get/v1/clients/{clientId}/instruments

Request

Base URL
https://apicore.stg.finch.lat
Auth
HTTP bearer
TypeScript
https://skmtc.dev/monato/apis/fincore-api/docs/v1/clients/:clientId/instruments/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

clientIdstring uuid required

Client identifier (UUID).

Query parameters

customer_idstring uuid

Optional customer UUID. When provided, filters instruments for this customer only.

pageinteger

Page number (1-based).

per_pageinteger

Number of items per page.

instrument_numberstring

Optional CLABE or debit-card number filter.

bank_idstring uuid

Optional destination bank UUID filter.

instrument_namestring

Optional holder-name filter.

Response

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

currentPageinteger required

Current page number.

perPageinteger required

Number of instruments returned per page.

totalItemsinteger required

Total number of instruments matching the request.

Example response

{
  "data": [
    {
      "id": "dd7f8d89-94dd-43ca-871b-720fde378b52",
      "bankId": "d3435bd9-998d-4e8a-9067-6b71d5fd3ac7",
      "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
      "ownerId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
      "alias": "Instrumento base",
      "type": "RECEIVER",
      "audit": {
        "createdAt": "2025-05-19 19:03:51.084659-06:00",
        "updatedAt": "2025-05-19 19:03:51.084668-06:00"
      },
      "rfc": "XAXX010101000",
      "customerId": "bb1e8fde-e68e-48e9-a483-d32153c752c2",
      "instrumentDetail": {
        "cardNumber": "5579072268574100",
        "holderName": "John Smith"
      }
    }
  ],
  "currentPage": 1,
  "perPage": 50,
  "totalItems": 17
}

Changes

Sep 26, 2026e22ef66945df Revision changes
- warning
  added the new SENDER_RECEIVER enum value to the ////// response property for the response status
- info
  api tag Instruments added
- info
  added the new optional query request parameter bank_id
- info
  added the new optional query request parameter instrument_name
- info
  added the new optional query request parameter instrument_number
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history