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

# List Payments

`GET /payments`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/payments`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

List the payments for your account. This endpoint supports [pagination](https://docs.justifi.tech/api-spec#section/Pagination).

## Query parameters

- `payment_method_id` string
- `void_id` string
- `created_before` string, date-time
- `created_after` string, date-time
- `payment_status` 'succeeded' | 'failed' | 'pending' | 'authorized' | 'refunded' | 'disputed'

## Headers

- `Authorization` string, required
- `Sub-Account` string

## Response `200`

Successfully list payments

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` unknown[]: the list of objects
    - unknown
  - `page_info` PageInfo
    - `end_cursor` string: the encoded id of the last record in the current list
    - `has_next` boolean: true if the collection contains records following the current list
    - `has_previous` boolean: true if the collection contains records ahead of the current list
    - `start_cursor` string: the encoded id of the first record in the current list

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)