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

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

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

## Request

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

Returns all S-100 User Permit Numbers (UPNs) associated with the requested licence. There can be one or more S-100 UPNs for a licence.

## Path parameters

- `licenceId` integer, required

## Response `200`

OK - Returns UPNs for the licence

- UserPermit[]
  - `title` string
  - `upn` string

## Other responses

- `204`: No Content - There are no UPNs for the licence.
- `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/userPermits/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)