Skip to main content
GET
/
v2
/
payment-links
List Payment Links
curl --request GET \
  --url https://api.example.com/v2/payment-links

​
List Payment Links

Returns a paginated list of payment links, ordered by creation date (most recent first). Supports filtering by status, customer, and date range.

​
Authentication

Authorization: Bearer glm_test_YOUR_API_KEY

​
Query Parameters

ParameterTypeDescription
limitintegerNumber of results per page (default: 10, max: 100)
starting_afterstringCursor for pagination (payment link ID)
statusenumFilter by status: active, paid, expired, cancelled
customer_emailstringFilter by customer email
payment_typeenumFilter by type: one_time, subscription
created_aftertimestampFilter links created after this date
created_beforetimestampFilter links created before this date

​
Response

All monetary amounts are integers in cents (e.g., 4995 = $49.95). 
{
  "data": [
    {
      "id": "plink_abc123",
      "url": "https://checkout.withgale.com/pay/plink_abc123",
      "amount": 4995,
      "currency": "USD",
      "description": "Blood Pressure Monitor",
      "payment_type": "one_time",
      "status": "paid",
      "customer": {
        "email": "customer@example.com"
      },
      "order": {
        "id": "ord_xyz789"
      },
      "created_at": "2026-02-25T14:30:00Z",
      "paid_at": "2026-02-25T15:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "plink_abc123"
}

​
Response Fields

FieldTypeDescription
dataarrayArray of payment link objects
has_morebooleanWhether more results are available
next_cursorstringCursor for next page (use as starting_after)

​
Examples

​
List All

curl https://api.withgale.com/v2/payment-links \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"

​
Filter by Status

curl "https://api.withgale.com/v2/payment-links?status=paid&limit=50" \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"

​
Filter by Customer

curl "https://api.withgale.com/v2/payment-links?customer_email=jane@example.com" \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"

​
Errors

Status CodeError CodeDescription
400invalid_requestInvalid query parameters
401unauthorizedInvalid or missing API key