---
title: "POST /payments/search"
method: POST
path: "/payments/search"
tags: ["Payments"]
---

# POST /payments/search

`POST /payments/search`

Searches payments.

## Request body

- PaymentListRequest — Request body for listing payments.
  - `payment_flow_id` string — Filter by payment flow ID.
  - `page_info` object — Pagination parameters.
    - `limit` number — Maximum number of results.
    - `after` string — Pagination cursor.

## Response `200`

Success

- PaymentListResponse — List of payments.
  - `data` Payment[], required
    - `id` string, required — FRAGMENT generated unique ID.
    - `external_id` string — User-provided unique ID when the payment was created with one.
    - `direction` string, required — Direction of the payment.
    - `amount` string, required — Amount in smallest currency unit.
    - `currency` string, required — Currency code.
    - `status` string, required — Status of the payment.
    - `payment_flow_id` string, required — Payment flow ID.
    - `payment_account_id` string, required — Payment account ID.
    - `transaction_ids` string[], required — Associated transaction IDs.
    - `created` string, required — Timestamp when the payment was created.
    - `modified` string, required — Timestamp when the payment was last modified.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-04-23** `2313a4acc241` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/changes/payments/search/post.md)

---

[API](https://skmtc.dev/fragment-dev/apis/fragment-payments-api.md) · [All operations](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fragment-dev/fragment-payments-api/revisions/41ca2c686012/schema)