GET
/
v1
/
orders
curl "https://api-eu.sulpayments.ch/v1/orders?status=paid&from=2026-01-01&per_page=50" \
  -H "Authorization: Bearer {token}"

{
  "orders": [
    {
      "id": "ord_5f1a3b2c",
      "external_reference": "ORDER-001",
      "customer_name": "Jane Doe",
      "customer_email": "jane@example.com",
      "description": "Subscription",
      "status": "paid",
      "paid_at": "2026-02-15T14:23:00Z",
      "payment_method": "credit_card",
      "payments": []
    }
  ],
  "total_pages": 12,
  "current_page": 1,
  "per_page": 50
}

​
Headers

​
Authorization
string
required
Bearer {token}

​
Query parameters

​
status
string
Filter by status (paid, waiting_payment, refunded, chargeback, etc).
​
payment_method
string
Filter by payment method.
​
from
string
ISO 8601 start date.
​
to
string
ISO 8601 end date.
​
sort
string
One of created_at, updated_at, paid_at, compensated_at, refunded_at, chargeback_claimed_at, chargebacked_at, chargeback_won_at.
​
direction
string
asc or desc.
​
page
integer
default:"1"
​
per_page
integer
default:"30"
Maximum 200.

​
Response

​
orders
array
Array of order objects.
​
total_pages
integer
​
current_page
integer
​
per_page
integer
curl "https://api-eu.sulpayments.ch/v1/orders?status=paid&from=2026-01-01&per_page=50" \
  -H "Authorization: Bearer {token}"

{
  "orders": [
    {
      "id": "ord_5f1a3b2c",
      "external_reference": "ORDER-001",
      "customer_name": "Jane Doe",
      "customer_email": "jane@example.com",
      "description": "Subscription",
      "status": "paid",
      "paid_at": "2026-02-15T14:23:00Z",
      "payment_method": "credit_card",
      "payments": []
    }
  ],
  "total_pages": 12,
  "current_page": 1,
  "per_page": 50
}