---
title: "List payment requests"
method: GET
path: "/payments/v1/payment-requests"
tags: ["Payment requests"]
---

# List payment requests

`GET /payments/v1/payment-requests`

List previously created payment requests. Filter with either (but not both) account ID in `from` or `to`.

## Query parameters

- `from` string
- `to` string
- `status` string

## Headers

- `x-tenant` string
- `x-cid` string

## Response `200`

OK

- PaymentRequestItemResponse[] — Payment request list
  - `amount` number — Payment request amount.
  - `processing_code` string — Payment request processing code.
  - `to` integer — Target account ID.
  - `expiration` string — Payment request expiration date in UTC-0 (RFC3339) format.
  - `location` Location — Request latitude and longitude object.
    - `lat` number, float — Request latitude.
    - `lng` number, float — Request longitude.
  - `tracking_id` string — Optional unique ID correlating the payment request's associated credit and debit authorizations.
  - `status` 'PAID' | 'PENDING' | 'EXPIRED' | 'DELETED' | 'REJECTED' | 'CANCELLED' | 'ACTIVE' — Payment request status
  - `id` string — Payment request unique ID.
  - `creation_date` string, date-time — Payment request creation date in UTC-0 (RFC3339) format.
  - `metadata` string — Any data object with key/value pairs. No limit on length. **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)