List subscriptions

GET
/subscriptions

Authorization

bearerAuth
headerAuthorizationBearer <token>

Authorization: Bearer hh_live_.... Create and revoke keys in Organizer → Settings → API. A key carries full access to its partner's data, including refunds and promo codes — treat it as a production credential and keep it server-side.

Query Parameters

page?integer

1-based page number.

Range1 <= value
Default1
per_page?integer

Results per page. Values above the maximum are clamped, not rejected.

Range1 <= value <= 50
Default20
status?string
Value in"active""cancelled""past_due""expired"
tier_id?string
Formatuuid

Response Body

A page of subscriptions.

application/json
  1. response
data?
Example Request
curl -X GET 'https://hanghut.com/api/v1/subscriptions'
Example Response
{  "data": {    "subscriptions": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "status": "active",        "tier": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "price": 0,          "interval": "string",          "is_active": true,          "perks": [            {}          ]        },        "current_period_end": "2019-08-24T14:15:22Z",        "cancelled_at": "2019-08-24T14:15:22Z",        "created_at": "2019-08-24T14:15:22Z"      }    ],    "meta": {      "page": 0,      "per_page": 0,      "total": 0,      "total_pages": 0,      "has_more": true    }  }}