---
title: "Gets a subscription's voice number licenses."
method: GET
path: "/subscriptions/{subscriptionId}/inboundVoiceNumberLicenses"
tags: ["Subscriptions"]
---

# Gets a subscription's voice number licenses.

`GET /subscriptions/{subscriptionId}/inboundVoiceNumberLicenses`

## Request

- Base URL: `https://connect.signl4.com/api`
- URL: `https://connect.signl4.com/api/subscriptions/{subscriptionId}/inboundVoiceNumberLicenses`
- Auth: none required
- TypeScript: <https://skmtc.dev/signl4/apis/signl4-api-v1/docs/subscriptions/:subscriptionId/inboundVoiceNumberLicenses/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `subscriptionId` string, required

## Response `200`

OK

- VoiceInboundNumberLicenseInfo
  - `currentNumbers` integer
  - `licensedNumbers` integer
  - `planCode` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-06-08** `53dbce1f7f35`: 12 warning, 6 info
  - removed the optional property `currentUsers` from the response with the `200` status (media type: text/plain)
  - removed the optional property `currentUsers` from the response with the `200` status (media type: application/json)
  - removed the optional property `currentUsers` from the response with the `200` status (media type: text/json)
  - removed the optional property `isFree` from the response with the `200` status (media type: text/plain)
  - …14 more
- **2025-05-16** `80a3a05166d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signl4/apis/signl4-api-v1/changes/subscriptions/:subscriptionId/inboundVoiceNumberLicenses/get.md)

---

[API](https://skmtc.dev/signl4/apis/signl4-api-v1.md) - [All operations](https://skmtc.dev/signl4/apis/signl4-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/signl4/apis/signl4-api-v1/revisions/bf9d377a0764?raw)