Docs

Get All Subscriptions

Get all subscriptions filtered by customer.

Path

GET /v1/clients/{clientId}/subscriptions

Request Parameters

clientId

required

integer

Your assigned `ClientId`.

customerNumber

required

string

Id of the customer.

Responses

type

required

string

The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type.

category

required

string

Enum:

BUSINESS_ERROR

TECHNICAL_ERROR

Category of the error, used primarily to determine whether the same request should be retried or not. Possible values: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

type

required

string

The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type.

category

required

string

Enum:

BUSINESS_ERROR

TECHNICAL_ERROR

Category of the error, used primarily to determine whether the same request should be retried or not. Possible values: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

required

array

A list of validation failures for the request.

Successful Request

Unsuccessful Request, Incorrect Customer Number

Request Example

    
        null

Response Example

    
        [
 {
  "id": "subscription-id-1",
  "product": {
   "id": "subscription-product-id-1",
   "description": "Go Free 8GB"
  },
  "_links": [
   {
    "method": "GET",
    "href": "https://api-dev.horizonafs.io/subscription/v1/clients/1234/subscriptions/subscription-id-1",
    "rel": "self"
   },
   {
    "method": "GET",
    "href": "https://api.horizonafs.io/subscription/v1/clients/1234/subscription-products/subscription-product-id-1",
    "rel": "subscription-product"
   }
  ]
 }
]

Request Example

    
        null

Response Example

    
        {
 "type": "https://developer.horizonafs.io/errors/resource-not-found",
 "category": "BUSINESS_ERROR",
 "title": "Resource not found",
 "message": "Resource not found"
}