---
title: "Get number of payments by transaction (payment) state"
method: GET
path: "/v1/report/payments_by_state"
tags: ["Reports"]
---

# Get number of payments by transaction (payment) state

`GET /v1/report/payments_by_state`

## Request

- Base URL: `http://ledger_url`
- URL: `http://ledger_url/v1/report/payments_by_state`
- Auth: none declared

## Query parameters

- `account_id` string
- `include_moto_statistics` boolean
- `from_date` string
- `to_date` string
- `override_account_id_restriction` boolean

## Response `200`

OK

- object

## Other responses

- `422`: Missing required or invalid query parameters (from_date or to_date)

## Changes

- **2026-10-05** `450e568b5b08`: 2 warning, 1 info
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `422`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_STRIPE` enum value to the `error_identifier` response property for the response status `422`
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `422`
- **2025-01-16** `ef12d134c115`: 1 warning
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `422`
- **2024-11-25** `6a7b3b19bd40`: 1 warning
  - added the new `NON_HTTPS_RETURN_URL_NOT_ALLOWED_FOR_A_LIVE_ACCOUNT` enum value to the `error_identifier` response property for the response status `422`
- **2023-07-06** `8563b7d75ea6`: 1 warning
  - added the new `CARD_NUMBER_IN_PAYMENT_LINK_REFERENCE_REJECTED` enum value to the `error_identifier` response property for the response status `422`
- **2023-03-16** `d06cd3b61b6c`: 1 warning
  - added the new `IDEMPOTENCY_KEY_USED` enum value to the `error_identifier` response property for the response status `422`

[Operation history](https://skmtc.dev/government-digital-service/apis/ledger-api/changes/v1/report/payments_by_state/get.md)

---

[API](https://skmtc.dev/government-digital-service/apis/ledger-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/ledger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/ledger-api/revisions/450e568b5b08?raw)