# Product information

> How to get the name and version of the cash register software, the API service and the connected storage, the SWID and the operating system eKasa runs on.

Source: https://ekasa.ninedigit.sk/en/docs/product-info

Product information returns the name and version of the cash register software (PPEKK), the API service and the
connected protected data storage, the SWID identifier and the operating system. It is useful for diagnostics and for
showing in the about information of your software.

## Getting product information

**HTTP API:**

```http
GET {server_address}/api/v1/product/info
```

**.NET library:**

```csharp
EKasaProductInfo productInfo = await client.GetProductInfoAsync(cancellationToken);
```

The library returns the same data except `api` (the API service version).

Example response from an API service deployed on Android 14:

```json
{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "d1e080d619fcbecc06d8e3d34cbc736a7b1dad47",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.9"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.9"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  },
  "operatingSystem": {
    "platform": "Android",
    "architecture": "Arm64",
    "description": "Android 14",
    "version": "14"
  }
}
```

Example response from an API service deployed on 64-bit Windows 10:

```json
{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "d1e080d619fcbecc06d8e3d34cbc736a7b1dad47",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.9"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.9"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  },
  "operatingSystem": {
    "platform": "Windows",
    "architecture": "X64",
    "description": "Microsoft Windows 10.0.26200",
    "version": "Microsoft Windows NT 10.0.26200.0"
  }
}
```

Example response from an older version of the API service (9.0.5 and older), which does not include the
`operatingSystem` property yet:

```json
{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "806c3e0728bb5e0bd096d651d4e65372752d8490",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.5"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.3+256a161235f18034e859989e16795c38410607c0"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  }
}
```

## Response properties

| Property | Description |
|---|---|
| `vendorName` | Name of the cash register software vendor. |
| `swid` | Unique identifier of the cash register software (SHA-1). It is derived from the vendor name, the name and version of the cash register software, and the name and version of the protected data storage. All receipts sent to the eKasa system of the Financial Administration of the Slovak Republic are marked with this identifier. |
| `api` | Name and version of the API service. It is a layer on top of the certified cash register software that provides the web API. |
| `ppekk` | Name and version of the embedded certified cash register software. |
| `chdu` | Name and version of the connected protected data storage. |
| `operatingSystem` | Description of the operating system the API service runs on. |

The `api` and `ppekk` versions are independent of each other and do not have to match. The API service for Android
and the API service for desktop are released separately, so the same version number in `api` does not mean the same
release.

## The `operatingSystem` property

*Available from version `9.0.6`.*

Describes the operating system of the device the API service is deployed on.

### `operatingSystem.platform`

The operating system. If the API service does not recognise the system, the value is not given.

| Value | Description |
|---|---|
| `Windows` | Windows. |
| `Linux` | Linux. |
| `MacOS` | macOS. |
| `Android` | Android. |
| `null` | The system could not be recognised. |

### `operatingSystem.architecture`

Architecture of the API service process. It gives the architecture of the **process**, not the system: a 32-bit
service on a 64-bit system reports a 32-bit value.

Common values include `X86`, `X64`, `Arm` and `Arm64`.

### `operatingSystem.description`

A human-readable description of the system, intended for display to the operator and for diagnostics. For example
`Microsoft Windows 10.0.26200` or `Android 14`.

The format of the description is not fixed and may differ between versions and platforms.
To adjust the behaviour of your application, we recommend using the `platform` value.

### `operatingSystem.version`

The system version as reported by the system itself. On Android, it is the Android version (for example `14`).

If the system does not provide it, the value is `null`.
