---
title: "List records"
method: GET
path: "/records"
---

# List records

`GET /records`

Returns a paginated list of records, newest first. At least one of `data_stream_key`, `reconciliation_match_id`, `reconciliation_id`, `external_id`, `import_batch_id`, or `bulk_request_id` is required.

Pagination is cursor-based: pass each response's `next_cursor` back as `cursor` until `next_cursor` is null. The legacy `offset` parameter and its `has_more`/`offset`/`total_count` response shape have been removed.

## Query parameters

- `data_stream_key` string
- `reconciliation_match_id` string
- `reconciliation_id` string
- `external_id` string
- `import_batch_id` integer
- `bulk_request_id` integer
- `created_after` string, date-time
- `created_before` string, date-time
- `source` 'single_api' | 'csv_upload' | 'nacha_upload' | 'bulk_api' | 'plaid'
- `status` 'matched' | 'unmatched'
- `cursor` string
- `limit` integer

## Response `200`

Paginated list of records

- object
  - `data` Record[]
    - `id` integer
    - `amount` integer, required — The monetary amount in cents (e.g., 1234 = $12.34)
    - `currency` string — Three-letter ISO 4217 currency code (e.g. USD, EUR). **Optional on create — defaults to `USD` when omitted.** Case-insensitive on input; always returned uppercase.
    - `decimal_places` integer — Number of decimal places for this currency (2 for USD)
    - `direction` 'credit' | 'debit', required
    - `description` string
    - `date` string, date, required
    - `metadata` object
    - `external_id` string
    - `data_stream_key` string, required
  - `next_cursor` string, nullable — Opaque cursor for the next page. Null when no more pages.
  - `limit` integer

## Other responses

- `422` — No scoping filter provided, or invalid `status`, `created_after`, or `created_before`

---

[API](https://skmtc.net/endclose/apis/end-close-api.md) · [All operations](https://skmtc.net/endclose/apis/end-close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/endclose/end-close-api/revisions/613ceff68dc7/schema)