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

# List Payments

`GET /api/internal/payments`

List payments with optional filters.

## Query parameters

- `user_id` string
- `org_id` string
- `invoice_id` string, nullable — Filter by invoice UUID
- `client_id` string, nullable — Filter by client UUID
- `payment_type` string, nullable — Filter by payment type: stripe, cash, cheque, credit_card, bank_transfer, other
- `invoice_number` string, nullable — Filter by invoice number
- `order_by` string, nullable — Column to sort by (e.g., payment_date, amount, created_at)
- `order_desc` boolean, nullable — Sort in descending order (most recent first)
- `limit` integer — Maximum number of payments to return
- `offset` integer — Number of payments to skip

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/revisions/9744001af85d/schema)