---
title: "GET /v1/licences/{licenceId}/s100/holdings"
method: GET
path: "/v1/licences/{licenceId}/s100/holdings"
tags: ["DRAFT"]
---

# GET /v1/licences/{licenceId}/s100/holdings

`GET /v1/licences/{licenceId}/s100/holdings`

## Request

- Base URL: `https://shop-facade-service-url`
- URL: `https://shop-facade-service-url/v1/licences/{licenceId}/s100/holdings`
- Auth: HTTP bearer

Get holdings for the requested licence.

## Path parameters

- `licenceId` integer, required

## Response `200`

OK - Returns holdings available for the licence.

- object
  - `unitName` string: unitName define the type of unit.
  - `unitTitle` string: unitTitle define the title of unit.
  - `expiryDate` string: expiryDate of the unit.
  - `datasets` object[]
    - `datasetName` string
    - `datasetTitle` string
    - `latestEditionNumber` integer
    - `latestUpdateNumber` integer

## Other responses

- `204`: No Content - There are no holdings for the given licenceId.
- `400`: Bad request - could be missing or invalid licenceId, it must be an integer and greater than zero.
- `401`: Unauthorised - either you have not provided valid token, or your token is not recognised.
- `403`: Forbidden - you have no permission to use this API.
- `404`: Licence not found.
- `500`: Internal Server Error.

## Changes

- **2025-02-17** `8ebefb665fe6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/uk-hydrographic-office/apis/ukho-shop-facade-service-apis/changes/v1/licences/:licenceId/s100/holdings/get.md)

---

[API](https://skmtc.dev/uk-hydrographic-office/apis/ukho-shop-facade-service-apis.md) - [All operations](https://skmtc.dev/uk-hydrographic-office/apis/ukho-shop-facade-service-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/uk-hydrographic-office/apis/ukho-shop-facade-service-apis/revisions/1e0e14893f16?raw)