---
title: "List payments"
method: GET
path: "/payments"
tags: ["Payments"]
---

# List payments

`GET /payments`

## Request

- Base URL: `https://api.moonclerk.com`
- URL: `https://api.moonclerk.com/payments`
- Auth: API key in header `Authorization`

Returns individual payments. Filters may be combined; date filters are `YYYY-MM-DD` and UTC-based, with `date_from` starting at the beginning of the day and `date_to` running through the end of it.

## Query parameters

- `count` integer
- `offset` integer
- `form_id` integer
- `customer_id` integer
- `date_from` string, date
- `date_to` string, date
- `status` 'successful' | 'refunded' | 'failed'

## Response `200`

A page of payments.

## Other responses

- `401`: Missing or invalid API key. The body is currently `text/plain` (`HTTP Token: Access denied.`), not JSON.
- `429`: Throttling limit exceeded. Reduce the number and frequency of calls, then retry. No `RateLimit` or `Retry-After` headers are currently published.
- `500`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `502`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `503`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.
- `504`: MoonClerk is unavailable — `500` means the app is entirely down; `502`, `503` and `504` are gateway and timeout conditions. Retrying later is the caller's responsibility.

---

[API](https://skmtc.dev/moonclerk/apis/moonclerk-api.md) · [All operations](https://skmtc.dev/moonclerk/apis/moonclerk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/moonclerk/apis/moonclerk-api/revisions/168fe9354080?raw)