List customer subscriptions

Lists all subscriptions for a customer.

get/api/v1/customers/{customerIdOrKey}/subscriptions

Path parameters

string required

ULID (Universally Unique Lexicographically Sortable Identifier).

string required

ExternalKey is a looser version of key.

Example:01G65Z755AFWAKHE12NY0CQ9FH

Query parameters

statusSubscriptionStatus[]

order'ASC' | 'DESC'

The order direction.

orderBy'activeFrom' | 'activeTo'

Order by options for customer subscriptions.

The order by field.

pageinteger

Page index.

Default is 1.

pageSizeinteger

The maximum number of items per page.

Default is 100.

Response

The request has succeeded.

pageinteger required

The page index.

pageSizeinteger required

The maximum number of items per page.

totalCountinteger required

The total number of items.

Example response

{
  "items": [
    {
      "activeFrom": "2023-01-01T01:01:01.001Z",
      "activeTo": "2023-01-01T01:01:01.001Z",
      "annotations": {
        "externalId": "019142cc-a016-796a-8113-1a942fecd26d"
      },
      "billingAnchor": "2023-01-01T01:01:01.001Z",
      "billingCadence": "P1M",
      "costBasisPins": [
        {
          "costBasisId": "01G65Z755AFWAKHE12NY0CQ9FH",
          "customCurrencyId": "01G65Z755AFWAKHE12NY0CQ9FH",
          "invoiceCurrency": "USD"
        }
      ],
      "createdAt": "2024-01-01T01:01:01.001Z",
      "currency": "USD",
      "customerId": "01G65Z755AFWAKHE12NY0CQ9FH",
      "deletedAt": "2024-01-01T01:01:01.001Z",
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "metadata": {
        "externalId": "019142cc-a016-796a-8113-1a942fecd26d"
      },
      "plan": {
        "id": "01G65Z755AFWAKHE12NY0CQ9FH"
      },
      "updatedAt": "2024-01-01T01:01:01.001Z"
    }
  ],
  "page": 1,
  "pageSize": 100,
  "totalCount": 500
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.