Easy Labs
APIBillingSubscription plan

Get subscription plans (legacy compatibility)

Legacy compatibility endpoint for legacy Finix plan IDs. New integrations should rely on product/price-first endpoints for recurring setup.

GET
/v1/api/subscription-plans/

Authorization

apiKey
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Query Parameters

limit?number
Range0 <= value
offset?number
Range0 <= value
ids?string

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/v1/api/subscription-plans/"
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": [
    {
      "id": "SPxxxxxxxxxxxxxxxxxx",
      "name": "Premium Monthly",
      "amount": 2999,
      "currency": "USD",
      "billing_interval": "MONTHLY",
      "billing_interval_count": 1,
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}

Get a subscription plan by ID (legacy compatibility)

Legacy compatibility endpoint for legacy Finix plan IDs. `include=prices` joins product_prices linked to the plan via finix_subscription_plan_id (dashboard catalog detail view).

Update a subscription plan (legacy compatibility)

Legacy compatibility endpoint for legacy Finix plan records. For new flows, update price-level catalog data instead.