# List all customer Subscriptions

**GET /v1/customers/{customerId}/subscriptions**

Returns a list of subscriptions for the provided customer. The subscriptions are returned sorted by the specified sortPropertyName.


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.

### Path parameters
- **customerId** (string(uuid))
  The GUID identifier for the customer. The subscriptions are listed only the selected customer.

### Query parameters
- **pageNumber** (integer(int32))
  A cursor for pagination across multiple pages of results. The default value is 1.
- **pageSize** (integer(int32))
  The number of objects to be returned at each page. The size can range between 1 and 2000, and the default is 25.
- **searchValue** (string)
  The search query string.
- **sortPropertyName** (string)
  The name of the property to sort the customers by. Possible values: Offer.Name
- **ascendingOrder** (boolean)
  if set to `true` [ascending order].
- **subscriptionStatuses** (string)
  A string containing the SubscriptionStatuses to filter by. This string is a list separated by |. ex: Active|Suspended
- **subscriptionOfferTypes** (string)

- **resellerId** (string(uuid))
  The reseller identifier. View only the customer subscriptions for this reseller.
- **offerId** (string(uuid))
  The offer identifier to search by an offer if specified.


## Responses
### 200
OK

#### Body: application/json (object)
- **items** (array[object] | null)
  The items for this page.
- **paginationParameters** (object)
  A model that is used to encapsulate the parameters needed to perform pagination queries.
- **totalPages** (integer(int32))
  The total number of pages available for the specified parameters and page size.
- **totalCount** (integer(int32))
  The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.
- **hasPreviousPage** (boolean)
  Indicates if there is a previous page.
- **hasNextPage** (boolean)
  Indicates if there is a next page.
- **continuationToken** (string | null)
  The token to continue to retrieve the paginated items.

### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)