# List payments

Endpoint: GET /v1/payments
Version: 2.0.0
Security: oAuth2

## Query parameters:

  - `status` (string)
    Enum: "created", "pending", "succeeded", "failed", "cancelled"

  - `railType` (string)
    Enum: "FIAT_FIAT", "FIAT_CRYPTO", "CRYPTO_FIAT", "CRYPTO_CRYPTO"

  - `createdAfter` (string)

  - `createdBefore` (string)

  - `limit` (integer)

  - `cursor` (string)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.paymentId` (string, required)
    Example: "pay_01JH..."

  - `items.status` (string, required)
    Enum: "created", "pending", "succeeded", "failed", "cancelled"

  - `items.createdAt` (string, required)

  - `items.railType` (string, required)
    Enum: "FIAT_FIAT", "FIAT_CRYPTO", "CRYPTO_FIAT", "CRYPTO_CRYPTO"

  - `items.amount` (number, required)

  - `items.currency` (string, required)

  - `items.destination` (object, required)

  - `items.destination.type` (string, required)
    Enum: "handle", "phone", "address"

  - `items.destination.value` (string, required)
    Example: "@recipient"

  - `items.network` (string)
    Enum: "ethereum", "polygon", "solana", "bitcoin"

  - `items.quoteId` (string,null)

  - `items.providerRef` (string,null)

  - `items.txHash` (string,null)

  - `pagination` (object)

  - `pagination.nextCursor` (string,null)
    Example: "cursor_abc123"