---
updatedAt: 2025-02-12T22:19:07.000Z
agentTools:
  projectIndex: https://developers.melroselabs.com/llms.txt
---

# List allocated numbers

Get list of allocated numbers

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Voice API",
    "description": "The Voice API is used for text-to-speech, speech-to-text and inbound/outbound voice routing. API keys for including as the x-api-key header in requests can be obtained at <a href=\"https://melroselabs.com\">https://melroselabs.com</a>. The Voice API is part of the <a href=\"https://melroselabs.com/services/voice-gateway/\">Voice Gateway</a> from Melrose Labs.<br/><br/><strong>Numbering</strong><br/><br/>The Inbound Voice service allows voice calls from landlines and mobiles to be received by a telephone number and routed to a VoIP SIP endpoint of your choice. You can allocate to your account, and receive calls on, telephone numbers from supported countries.<br/><br/><strong>Speech-to-Text</strong><br/><br/>The Speech-to-Text service allows an application to have a speech-to-text (STT) conversion performed on a long or short voice stream and for the speech to be transcribed as text.<br/><br/><strong>Text-to-Speech</strong><br/><br/>The Text-to-Speech service allows an application to have a text-to-speech (TTS) conversion performed on a long or short text and for the resulting voice stream to be delivered via a number of different channels.<br/><br/>",
    "contact": {
      "name": "Melrose Labs - Technical Support",
      "email": "support@melroselabs.com"
    },
    "version": "2020-08-15T00:09:00Z"
  },
  "servers": [
    {
      "url": "https://api.melroselabs.com/{basePath}",
      "variables": {
        "basePath": {
          "default": "/voice"
        }
      }
    }
  ],
  "paths": {
    "/numbering": {
      "get": {
        "tags": [
          "Numbering"
        ],
        "summary": "List allocated numbers",
        "description": "Get list of allocated numbers",
        "responses": {
          "200": {
            "description": "List of allocated numbers",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Empty"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Empty": {
        "title": "Empty Schema",
        "type": "object"
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```