list_dids_in_country_city

Retrieve available Direct Inward Dialing (DID) numbers in a specific city and country. Filter by SMS capability, view pricing, activation details, and required documents for purchase. Returns structured JSON data with pagination support.

Instructions

List of available DID in a city of a country

Args: country_id: ID of country for search city_id: ID of city in a country sms_enabled: search for DID with SMS functionality page: page of result starting with 1 per_page: how many results should be on per page

Returns a JSON object with available DIDs where: dids: Array of DID available for purchasing where: id: ID of DID country: Country name city: City name sms_enabled: Is number capable of receiving SMS channels: How many parallel channels have DID free_min: How many free minutes per month DID have activation: Activation cost for DID in USD monthly: Monthly fee for DID per_minute: Per minute cost for DID origination_per_min: per minute cost if origin based rate applied required_documents: required documents for activating number, where: 1 = Any form of ID 2 = Proof of address 3 = Proof of local address number: DID Number in E164 format pagination: Pagination details for results page: current page of results total_pages: total pages results total: total query records

403 error indicates disabled API calls for purchase.

Example:

{
    "dids": {
        "pagination": {
            "total": 52,
            "total_pages": 1,
            "current_page": 1
        },
        "dids": [
            {
                "id": 112370,
                "country": "Canada",
                "city": "Edmonton, AB",
                "sms_enabled": false,
                "no_local_cli": false,
                "channels": 4,
                "free_min": 0,
                "cnam": null,
                "activation": 1.0,
                "monthly": 1.0,
                "per_minute": 0.01,
                "origination_per_min": null,
                "required_documents": [],
                "state": "Alberta",
                "country_short_name": "CA",
                "number": "17806999999"
            }
        ]
    }
}

Input Schema

Name	Required	Description
`city_id`	Yes	City ID
`country_id`	Yes	Country ID
`page`	No	Search page
`per_page`	No	Search per page
`sms_enabled`	No	Filter for sms enabled numbers

Input Schema (JSON Schema)

{
  "properties": {
    "city_id": {
      "description": "City ID",
      "title": "City Id",
      "type": "integer"
    },
    "country_id": {
      "description": "Country ID",
      "title": "Country Id",
      "type": "integer"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search page",
      "title": "Page"
    },
    "per_page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search per page",
      "title": "Per Page"
    },
    "sms_enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter for sms enabled numbers",
      "title": "Sms Enabled"
    }
  },
  "required": [
    "country_id",
    "city_id"
  ],
  "title": "list_dids_in_country_cityArguments",
  "type": "object"
}

didlogic_mcp