---
title: "List Instruments"
method: GET
path: "/instruments"
tags: ["instruments"]
---

# List Instruments

`GET /instruments`

List instruments with cursor-based pagination.

Pagination:
- cursor: Opaque cursor from previous response
- Use `next_cursor` from response for next page

## Query parameters

- `limit` integer — Maximum number of records to return
- `cursor` string, nullable — Cursor for pagination (use next_cursor from previous response)

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- InstrumentListResponse — Schema for paginated instrument list responses.
  - `instruments` union[], required
    - union
      - InstrumentResponseMexicanClabe
        - `org_id` string, uuid, required — ID of the organization this instrument belongs to
        - `customer_id` string, uuid, required — ID of the customer that owns this instrument
        - `type` 'mx_direct_debit_card' | 'mx_clabe', required — Instrument type enum.
        - `description` string, nullable — Description of the instrument
        - `status` 'active' | 'inactive' | 'verification_in_progress' | 'errored' — Instrument status enum.
        - `mx_clabe` MXClabeInstrument — Schema for creating a new card instrument.
          - `clabe` string, required — CLABE number
          - `can_credit` boolean, nullable — Whether this instrument can receive credits
          - `can_debit` boolean, nullable — Whether this instrument can be debited
        - `currency` string, nullable — ISO 4217 currency code
        - `ownership_verification_result` 'no_match' | 'matched' | 'errored' — Verification result enum.
        - `ownership_verification_result_at` string, date-time, nullable — When ownership verification was completed
        - `id` string, uuid, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, nullable
      - InstrumentResponseMexicanDirectDebitCard
        - `org_id` string, uuid, required — ID of the organization this instrument belongs to
        - `customer_id` string, uuid, required — ID of the customer that owns this instrument
        - `type` 'mx_direct_debit_card' | 'mx_clabe', required — Instrument type enum.
        - `description` string, nullable — Description of the instrument
        - `status` 'active' | 'inactive' | 'verification_in_progress' | 'errored' — Instrument status enum.
        - `mx_direct_debit_card` MXDirectDebitCardInstrument — Schema for creating a new card instrument.
          - `card_number` string, required — Card number
          - `bank` 'mx_santander' | 'mx_banorte' | 'mx_bbva' | 'mx_banamex' | 'mx_hsbc' | 'mx_citi' | 'mx_banjercito' | 'mx_bajio' | 'mx_inbursa' | 'mx_invex' | 'mx_america' | 'mx_vepormas' | 'mx_azteca' | 'mx_multiva' | 'mx_actinver' | 'mx_bancoppel' | 'mx_fundaciondonde' | 'mx_bancrea' | 'mx_bankaaol' | 'mx_scotiabank' | 'mx_banregio' | 'mx_afirme' | 'mx_compartamos' | 'mx_base' | 'mx_ci' | 'mx_mifel' | 'mx_interbanco' | 'mx_sabadell', required
        - `currency` string, nullable — ISO 4217 currency code
        - `ownership_verification_result` 'no_match' | 'matched' | 'errored' — Verification result enum.
        - `ownership_verification_result_at` string, date-time, nullable — When ownership verification was completed
        - `id` string, uuid, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, nullable
  - `limit` integer, required
  - `has_next` boolean
  - `has_previous` boolean
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

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