---
title: "List statement periods"
method: GET
path: "/api/v1/statements/periods"
tags: ["API"]
---

# List statement periods

`GET /api/v1/statements/periods`

## Request

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

Read native statement and book balances, pending lines and unmatched book records. Closed requires exact balance, no pending lines and no outstanding records. Never post a balancing entry to force a close.

## Query parameters

- `bank_account_id` string, uuid, required
- `limit` integer
- `cursor` string

## Response `200`

Treasury result or immutable replay

- object
  - `request_id` string, required
  - `data` object[], required
    - `object` 'statement_period', required
    - `bank_account_id` string, uuid, required
    - `statement_id` string, uuid, nullable, required
    - `period_start` string, date, required
    - `period_end` string, date, required
    - `currency` 'ARS' | 'USD', required
    - `opening_balance` integer, nullable, required
    - `closing_balance` integer, nullable, required
    - `book_balance` integer, nullable, required
    - `difference` integer, nullable, required
    - `book_balance_quality` 'exact' | 'derived' | 'unavailable', required
    - `pending_line_count` integer, required
    - `line_count` integer, required
    - `status` 'open' | 'closed' | 'without_statement', required
    - `outstanding_records` ApiSharedObject7687b554ab[], required
      - `target_type` 'payment' | 'journal_entry', required
      - `target_id` string, uuid, required
      - `occurred_at` string, date, required
      - `amount` integer, required
      - `reference` string, nullable, required
      - `description` string, nullable, required
  - `object` 'list', required
  - `url` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Statement request could not be completed
- `401`: Statement request could not be completed
- `403`: Statement request could not be completed
- `404`: Statement request could not be completed
- `409`: Idempotency or statement state conflict
- `422`: Statement request could not be completed
- `429`: Statement request could not be completed
- `503`: Statement request could not be completed Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-05** `7b0bc8043efd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/statements/periods/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)