List your Numbers

Get a list of all Long code numbers assigned to your workspace.

You can filter your list of numbers using any of th following attributes:

• countryCode: 2 digit ISO code of the country, example: US for United States, we follow iso3166-1 standard.

• types: types of numbers your are searching for. Check API spec for allowed values.

• capabilities: the capabilities of the number (sms, mms, voice, whatsapp). Check API spec for allowed values..

• numberString: search numbers by their leading digits.

List Workspace Long Code Numbers

get

Authorizations

MessageBird_userMessageBird_accessKey

Path parameters

workspaceIdstringRequired

Query parameters

limitinteger · min: 1 · max: 99Optional

Limits the number of results to return

Default: 10

pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list

reversebooleanOptional

Order in which to retrieve the results

Default: false

numberStringstringOptional

countryCodesstring · iso3166-1[]Optional

providerIdsstring · uuid[]Optional

Responses

200

OK

application/json

Responseall of

get

HTTPcURLJavaScriptPython

GET /workspaces/{workspaceId}/numbers-long-code HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

OK

{
  "nextPageToken": "text",
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "endpointId": "123e4567-e89b-12d3-a456-426614174000",
      "numberString": "text",
      "countryCode": "text",
      "type": "local",
      "capabilities": {
        "voice": {
          "inbound": true,
          "outbound": true
        },
        "sms": {
          "inbound": true,
          "outbound": true
        },
        "mms": {
          "inbound": true,
          "outbound": true
        }
      },
      "createdAt": "2025-07-05T18:04:43.944Z",
      "updatedAt": "2025-07-05T18:04:43.944Z",
      "order": {
        "countryCode": "text",
        "type": "local",
        "capabilities": [
          "voice"
        ],
        "prefix": "text",
        "status": "draft",
        "createdAt": "2025-07-05T18:04:43.944Z",
        "updatedAt": "2025-07-05T18:04:43.944Z"
      },
      "deprovisionAt": "2025-07-05T18:04:43.944Z",
      "endpoint": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "type": "long-code-number",
        "instanceId": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "capabilities": [
          {
            "name": "sms",
            "inbound": {
              "status": "active",
              "issues": [
                "subscription-is-not-active"
              ]
            },
            "outbound": {
              "status": "active",
              "destinationStatuses": {
                "active": 1,
                "inactive": 1,
                "available": 1,
                "unavailable": 1
              },
              "supportsDestinations": true,
              "issues": [
                "subscription-is-not-active"
              ]
            }
          }
        ],
        "dependencies": [
          {
            "type": "connector",
            "connectorId": "123e4567-e89b-12d3-a456-426614174000",
            "connectorTemplateRef": "text",
            "capabilities": [
              "voice"
            ]
          }
        ],
        "issues": [
          "subscription-is-not-active"
        ],
        "provisioningStatus": "provisioned",
        "createdAt": "2025-07-05T18:04:43.944Z",
        "updatedAt": "2025-07-05T18:04:43.944Z"
      }
    }
  ]
}