---
title: "List checks"
method: GET
path: "/api/v1/checks"
tags: ["API"]
---

# List checks

`GET /api/v1/checks`

## Request

- Base URL: `https://api.lapyme.com.ar`
- URL: `https://api.lapyme.com.ar/api/v1/checks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lapyme/apis/la-pyme-api/docs/api/v1/checks/get.ts> (a function with typed inputs; its response is checked against the schema)

List visible checks by due date ascending (nulls last), then ID. status=received excludes checks assigned to supplier payments; add origin=third_party for cartera endorsement candidates.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'received' | 'deposited' | 'discounted' | 'cleared' | 'endorsed' | 'issued' | 'returned' | 'void'
- `origin` 'third_party' | 'own'
- `issuer` string
- `due_date_from` string, date
- `due_date_to` string, date

## Response `200`

List checks

- ApilistChecksResponse
  - `request_id` string, required
  - `object` 'list', required
  - `url` string, required
  - `data` ApiSharedObjectf061a22803[], required
    - `object` 'check', required
    - `id` string, uuid, required
    - `number` string, required
    - `bank_name` string, required
    - `issuer_name` string, nullable, required
    - `amount` integer, required
    - `currency` 'ARS' | 'USD', required
    - `issue_date` string, date, required
    - `due_date` string, date, nullable, required
    - `format` 'paper' | 'electronic', required
    - `origin` 'third_party' | 'own', required
    - `status` 'received' | 'deposited' | 'discounted' | 'cleared' | 'endorsed' | 'issued' | 'returned' | 'void', required
    - `source_receipt_id` string, uuid, nullable, required
    - `supplier_payment_id` string, uuid, nullable, required
    - `check_deposit_id` string, uuid, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid request, cursor or idempotency key
- `401`: Authentication required
- `403`: Insufficient scope or membership
- `404`: Resource not found or not visible
- `409`: Invalid transition or idempotency conflict
- `422`: Business requirement unmet
- `429`: Límite de solicitudes excedido para la organización
- `500`: Internal error
- `503`: Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-04** `9fe2244b8454`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/checks/get.md)

---

[API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/597a718d17bd?raw)