Docs/Admin API/Subscriptions/List

List subscriptions

GET/admin/v1/subscriptions

Lists subscriptions.

query parameters

  • organizationId

    string

    Filter results by organization identifier.

  • userId

    string

    Filter results by user identifier.

  • state

    enum

    Filter results by state.

    Possible values:
    CREATINGTRIALINGCHECKOUT_ISSUEACTIVEPAST_DUEPAUSEDCANCELED
  • planGroupId

    string

    Filter results by plan group identifier.

    You can specify unmanaged to see all subscriptions without a plan.

  • pageSize

    int32

    The maximum number of subscriptions to return. The API may return fewer than this value.

    If unspecified, at most 20 subscriptions will be returned. The maximum value is 100; values above 100 will be coerced to 100.

  • pageToken

    string

    A page token, received from a previous list subscriptions call. Provide this to retrieve the subsequent page.

    When paginating, all other parameters provided to list subscriptions must match the call that provided the page token.

  • orderBy

    string

    A comma-separated list of fields to order by.

    This is only supported when either organizationId or userId is specified.

    Supports:

    • active desc
    • createTime desc
    • startTime desc
  • view

    enum

    The Subscription view to return in the results.

    This defaults to the BASIC view.

    Possible values:
    BASICFULL

Returns

  • subscriptions

    Subscription[]

    The list of subscriptions.

  • nextPageToken

    string

    A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

  • previousPageToken

    string

    A token, which can be sent as pageToken to retrieve the previous page. If this field is absent, there are no preceding pages. If this field is an empty string then the previous page is the first result.

curl https://api.userhub.com/admin/v1/subscriptions?organizationId=org_28seyVGVL1got6 \
  -H "Authorization: Bearer $USERHUB_ADMIN_KEY"
Response bodyJSON
{
  "subscriptions": [
    {
      "id": "sub_UBUqH64iKRBdCD",
      "state": "ACTIVE",
      "connection": {
        "id": "conn_4HdRKnTvPmmjYK",
        "displayName": "Stripe",
        "state": "ACTIVE",
        "type": "STRIPE",
        "delegate": null,
        "providers": [],
        "createTime": "2024-11-15T13:00:00Z",
        "updateTime": "2024-11-15T13:00:00Z"
      },
      "externalId": "sub_1PGhMaI1Zx1mDKAzigGeR4s9",
      "plan": {
        "id": "pg_2wnGzPMSrDBYK5:ukfHizos:monthly:usd",
        "displayName": "Pro",
        "description": "The pro plan.",
        "currencyCode": "USD",
        "billingInterval": {
          "quantity": 1,
          "unit": "MONTH"
        },
        "tags": [
          "default"
        ],
        "items": []
      },
      "currencyCode": "USD",
      "items": [],
      "seats": [
        {
          "product": {
            "id": "pd_3fNK5BXs9C1Fdc",
            "uniqueId": "pro-seat",
            "displayName": "Pro seat",
            "description": "The pro seat.",
            "committed": true,
            "archived": false,
            "productConnections": [],
            "createTime": "2024-11-15T13:00:00Z",
            "updateTime": "2024-11-15T13:00:00Z"
          },
          "currentPeriodQuantity": 0,
          "assignedQuantity": 0,
          "unassignedQuantity": 0,
          "totalQuantity": 0
        }
      ],
      "paymentMethod": null,
      "anchorTime": "2024-11-15T13:00:00Z",
      "startTime": "2024-11-15T13:00:00Z",
      "endTime": null,
      "trial": null,
      "currentPeriod": {
        "startTime": "2024-11-15T13:00:00Z",
        "endTime": "2024-12-15T13:00:00Z"
      },
      "organization": {
        "id": "org_28seyVGVL1got6",
        "state": "ACTIVE",
        "displayName": "Acme Inc",
        "email": "[email protected]",
        "emailVerified": true,
        "imageUrl": "https://example.com/acme.jpg",
        "address": null,
        "accountConnections": [],
        "subscription": null,
        "signupTime": "2024-11-15T13:00:00Z",
        "memberCount": 0,
        "createTime": "2024-11-15T13:00:00Z",
        "updateTime": "2024-11-15T13:00:00Z"
      },
      "user": null,
      "default": true,
      "pullTime": "2024-11-15T13:00:00Z",
      "pushTime": "2024-11-15T13:00:00Z",
      "createTime": "2024-11-15T13:00:00Z",
      "updateTime": "2024-11-15T13:00:00Z"
    }
  ],
  "nextPageToken": ""
}
PreviousThe subscription object
NextGet a subscription

Build software thatmonetizes
$

Subscribe to monthly product updates

© 2025 UserHub

Integrations

    UserHub & Auth0UserHub & Stripe BillingUserHub & Google CloudUserHub & FirebaseUserHub & custom auth