GET /v1/subscriptions/plans

Returns a paginated list of subscription plans for your storefront. Requires authentication.

Request

GET /v1/subscriptions/plans

Query Parameters

Parameter	Type	Description
limit	number	Results per page (max 500, default 10)
offset	number	Number of results to skip (default 0)

Example

curl "https://api.nearpayments.io/v1/subscriptions/plans" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "count": 1,
  "result": [
    {
      "id": 1,
      "title": "Pro Monthly",
      "amount": 29.99,
      "currency": "usd",
      "interval_day": 30,
      "success_url": "https://example.com/success",
      "cancel_url": "https://example.com/cancel",
      "partially_paid_url": null,
      "ipn_callback_url": "https://example.com/webhook",
      "created_at": "2025-01-15T10:30:00.000Z",
      "updated_at": "2025-01-15T10:30:00.000Z"
    }
  ]
}