---
title: "Queries a ModelVersion by index."
method: GET
path: "/dcl/model/versions/{vid}/{pid}/{softwareVersion}"
tags: ["Query"]
---

# Queries a ModelVersion by index.

`GET /dcl/model/versions/{vid}/{pid}/{softwareVersion}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/zigbee-alliance/apis/distributed-compliance-ledger-rest-and-grpc-gateway-docs/docs/dcl/model/versions/:vid/:pid/:softwareVersion/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `vid` integer, required
- `pid` integer, required
- `softwareVersion` integer, required

## Response `200`

A successful response.

- object
  - `modelVersion` object
    - `vid` integer
    - `pid` integer
    - `softwareVersion` integer
    - `softwareVersionString` string
    - `cdVersionNumber` integer
    - `firmwareInformation` string
    - `softwareVersionValid` boolean
    - `otaUrl` string: Must be a valid HTTPS URL.
    - `otaFileSize` string, uint64
    - `otaChecksum` string: Base64-encoded digest; 44-88 characters when present.
    - `otaChecksumType` integer: Allowed values: 1 (sha-256), 7 (sha-384), 8 (sha-512), 10 (sha3-256), 11 (sha3-384), 12 (sha3-512).
    - `minApplicableSoftwareVersion` integer
    - `maxApplicableSoftwareVersion` integer
    - `releaseNotesUrl` string: Must be a valid HTTPS URL.
    - `creator` string
    - `schemaVersion` integer
    - `specificationVersion` integer

## Other responses

- `default`: An unexpected error response.

## Changes

- **2022-03-09** `39f038c61f18`: 1 info
  - api operation id `ZigbeeallianceDistributedcomplianceledgerModelModelVersion` removed and replaced with `ModelVersion`
- **2022-02-01** `5db4c8731508`: 1 info
  - endpoint added
- **2022-01-14** `94314a30e9c3`: 1 breaking
  - api path removed without deprecation
- **2021-12-27** `d7e8dcef2028`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zigbee-alliance/apis/distributed-compliance-ledger-rest-and-grpc-gateway-docs/changes/dcl/model/versions/:vid/:pid/:softwareVersion/get.md)

---

[API](https://skmtc.dev/zigbee-alliance/apis/distributed-compliance-ledger-rest-and-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/zigbee-alliance/apis/distributed-compliance-ledger-rest-and-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/zigbee-alliance/apis/distributed-compliance-ledger-rest-and-grpc-gateway-docs/revisions/b5ba63ddd069?raw)