> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inflowafrica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List payments

> Retrieve a paginated list of payments for the organization.



## OpenAPI

````yaml openapi.json get /v1/payments
openapi: 3.0.0
info:
  title: Inflow API
  version: 1.0.0
  description: API service for managing customer cards
  contact:
    name: API Support
servers:
  - url: https://sandbox.inflowafrica.com/api
    description: Sandbox
  - url: https://app.inflowpay.net/api
    description: Production
  - url: http://localhost:3000/api
    description: Local
security:
  - bearerAuth: []
tags: []
paths:
  /v1/payments:
    get:
      tags:
        - External API - Payments
      summary: List payments
      description: Retrieve a paginated list of payments for the organization.
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            default: 1
        - in: query
          name: limit
          schema:
            type: integer
            default: 20
        - in: query
          name: status
          schema:
            type: string
            enum:
              - created
              - pending
              - authorising
              - initiated
              - executed
              - settled
              - failed
              - cancelled
              - expired
        - in: query
          name: customerId
          schema:
            type: string
            format: uuid
          description: Optional customer ID to filter payments by customer.
      responses:
        '200':
          description: Paginated payment list
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token
    apiKeyAuth:
      type: http
      scheme: bearer
      description: Enter your API key starting with gtw_sk_

````