# Subscriptions

## Introduction

A subscription stores information regarding the contracts with your communication operators. It can exist as a standalone entity or integrated within the device.

## Comprehensive API actions

### Patching a subscription

- Please note that the administration channel value is mandatory for securitisation purposes in patch operation.
- In the event of patching complex objects, any non-passed object attributes will be patched as non-existent. Therefore, it is advisable to include previous unchanged values to avoid any loss of data.

### Searching subscriptions

The results can be obtained in two different formats, as detailed in the HTTP Header Options:

* JSON Format (the default)
* CSV Format

### Searching subscriptions summary

The summary will always display the total counter, the organisation grouping counter and the channel grouping counter by default.

## API specification

{{< openapi src="subscriptions.yaml" >}}