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

# List available numbers for a country/prefix

Get list of available telephone numbers for a country and given prefix

# 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/available/{country}/{prefix}": {
      "get": {
        "tags": [
          "Numbering"
        ],
        "summary": "List available numbers for a country/prefix",
        "description": "Get list of available telephone numbers for a country and given prefix",
        "parameters": [
          {
            "name": "country",
            "in": "path",
            "description": "Country for which querying for available numbers",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prefix",
            "in": "path",
            "description": "Prefix within country for which query for available numbers",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of available numbers for country and prefix",
            "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
  }
}
```