GET /payment/

Returns a paginated list of payments with optional filters. Requires authentication.

Request

GET /payment/

Query Parameters

Parameter	Type	Description
`track_id`	string	Filter by track ID
`type`	string	Filter by payment type
`status`	string	Filter by status
`pay_currency`	string	Filter by payment currency
`currency`	string	Filter by price currency
`network`	string	Filter by blockchain network
`address`	string	Filter by payment address
`from_date`	number	Start date (Unix timestamp)
`to_date`	number	End date (Unix timestamp)
`from_amount`	number	Minimum amount
`to_amount`	number	Maximum amount
`sort_by`	string	`create_date`, `pay_date`, or `amount`
`sort_type`	string	`asc` or `desc`
`page`	number	Page number (default 1)
`size`	number	Results per page (1–200, default 10)

Example

curl "https://api.nearpayments.io/oxapay/v1/payment/?status=Paid&size=20&sort_by=create_date&sort_type=desc" \
  -H "merchant_api_key: YOUR_API_KEY"

Response

{
  "data": {
    "list": [
      {
        "track_id": "abc123",
        "type": "invoice",
        "amount": 50,
        "currency": "USD",
        "status": "Paid",
        "date": 1699996400
      }
    ],
    "meta": {
      "page": 1,
      "last_page": 3,
      "total": 25
    }
  },
  "message": "Operation completed successfully!",
  "error": {},
  "status": 200,
  "version": "1.0.0"
}