---
title: "List all payments"
method: GET
path: "/billing/v1/payments"
tags: ["Payment"]
---

# List all payments

`GET /billing/v1/payments`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/billing/v1/payments`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/billing/v1/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

List all payments matching the input filters

## Query parameters

- `count` string
- `fromDate` number
- `method` 'ADP_INVOICE' | 'ARIBAPAY' | 'BT_BILL' | 'CLICKANDBUY' | 'CLOUDFOUNDRY' | 'CREDIT_CARD' | 'CUMULA_BILL' | 'DTAG' | 'EXTERNAL_INVOICE' | 'KREDITKARTE' | 'LASTSCHRIFT_MRNEXNET' | 'MANO_TEO_BILL' | 'MANUAL' | 'MARKETPLACE_CREDITS' | 'NETS_ARVATO_INVOICE' | 'NEXTEL' | 'PAYPAL' | 'ROGERS_CC_DTMF' | 'ROGERS_CC_POS' | 'SNAP' | 'TBILL' | 'THISTLE' | 'TOICLEARING'
- `result` 'FAILED' | 'GATEWAY_NOT_AVAILABLE' | 'MANUAL' | 'SUCCESSFUL'
- `sortField` 'AMOUNT' | 'DATE' | 'PAYMENT_ID'
- `sortOrder` 'ASC' | 'DESC'
- `start` string
- `toDate` number

## Response `200`

OK

- PaymentWS[]: OK
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `amount` number, nullable: Payment amount.
  - `company` LinkWS, nullable
    - `href` string
    - `id` string
  - `currency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
  - `date` number, nullable: Payment date.
  - `gatewayResponse` GatewayResponseWS
    - `avs` boolean: True if address is validated.
    - `code` string, nullable: Code.
    - `cvv` boolean: True if credit card is validated.
    - `message` string, nullable: Message.
  - `id` number, nullable: Payment number.
  - `method` 'CREDIT_CARD' | 'PAYPAL' | 'MANUAL' | 'EXTERNAL_INVOICE' | 'MARKETPLACE_CREDITS': The supported payment methods
  - `result` 'SUCCESSFUL' | 'FAILED' | 'GATEWAY_NOT_AVAILABLE' | 'MANUAL'
  - `transactionId` string, nullable: Transaction ID.
  - `user` LinkWS, nullable
    - `href` string
    - `id` string

## Other responses

- `204`: No content

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/billing/v1/payments/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)
