DocumentationEngagement Platform API
Sign inGet started
Guides
API

Get Long Code Number Details

Get the details of a specific Long code nnumber that you own.
GET
/workspaces/{workspaceId}/numbers-long-code/{longCodeNumberId}
This endpoint returns the information of a Long Code Number assigned to the workspace given its ID. You may use the EndpointID as well to search for your long code number.
Corps de la réponse
id
string
obligatoire
The unique identifier of the long code number. The endpoint ID is the same.
endpointId
string
obligatoire
The unique identifier of the endpoint. The long conde ID is the same.
numberString
string
obligatoire
The phone number in E.164 format.
countryCode
string
obligatoire
The country code in ISO 3166-1 alpha-2 format.
type
string
The type of long code number.
Possible values: local, national, toll-free, mobile
capabilities
object
obligatoire
Capabilities of the phone number. It shows if the phone number supports voice, sms and/or mms.
Afficher les attributs enfants
capabilities.voice
object
obligatoire
Afficher les attributs enfants
capabilities.voice.inbound
boolean
obligatoire
Whether the number supports inbound use cases.
capabilities.voice.outbound
boolean
obligatoire
Whether the number supports outbound use cases.
capabilities.sms
object
obligatoire
Afficher les attributs enfants
capabilities.sms.inbound
boolean
obligatoire
Whether the number supports inbound use cases.
capabilities.sms.outbound
boolean
obligatoire
Whether the number supports outbound use cases.
capabilities.mms
object
obligatoire
Afficher les attributs enfants
capabilities.mms.inbound
boolean
obligatoire
Whether the number supports inbound use cases.
capabilities.mms.outbound
boolean
obligatoire
Whether the number supports outbound use cases.
capabilities.whatsapp
object
Afficher les attributs enfants
capabilities.whatsapp.inbound
boolean
obligatoire
Whether the number supports inbound use cases.
capabilities.whatsapp.outbound
boolean
obligatoire
Whether the number supports outbound use cases.
createdAt
string
obligatoire
updatedAt
string
obligatoire
order
object
The order that created this long code number. It contains information such as the capabilities, order status and type.
Afficher les attributs enfants
order.countryCode
string
obligatoire
The country code in ISO 3166-1 alpha-2 format.
order.type
string
obligatoire
The type of long code number.
Possible values: local, national, toll-free, mobile
order.capabilities
array of string
obligatoire
order.prefix
string
order.status
string
obligatoire
Possible values: draft, submitted, processing, fulfilled, rejected, cancelled
order.createdAt
string
obligatoire
order.updatedAt
string
obligatoire
deprovisionAt
string
The date and time when the long code number should be deprovisioned.
endpoint
object
obligatoire
A representation of an endpoint. It contains details such as the capabilities, dependencies, and more.
Afficher les attributs enfants
endpoint.id
string
obligatoire
The ID of the endpoint.
endpoint.type
string
obligatoire
The type of the endpoint. It can be a long code number, short code number, alpha number, ip pool, or rcs google agent.
Possible values: long-code-number, short-code-number, alpha-number, ip-pool, rcs-google-agent
endpoint.instanceId
string
obligatoire
The unique identifier of the instance.
endpoint.name
string
obligatoire
The name of the endpoint. For some cases it will be the number in international format as string.
endpoint.capabilities
array of object
obligatoire
Afficher les attributs enfants
endpoint.capabilities.name
string
obligatoire
Possible values: sms
endpoint.capabilities.inbound
object
Afficher les attributs enfants
endpoint.capabilities.inbound.status
string
obligatoire
Possible values: active, inactive, available, unavailable
endpoint.capabilities.inbound.issues
array of string
endpoint.capabilities.outbound
object
Afficher les attributs enfants
endpoint.capabilities.outbound.status
string
obligatoire
Possible values: active, inactive, available, unavailable
endpoint.capabilities.outbound.destinationStatuses
object
Afficher les attributs enfants
endpoint.capabilities.outbound.destinationStatuses.active
number
endpoint.capabilities.outbound.destinationStatuses.inactive
number
endpoint.capabilities.outbound.destinationStatuses.available
number
endpoint.capabilities.outbound.destinationStatuses.unavailable
number
endpoint.capabilities.outbound.supportsDestinations
boolean
Whether the number supports destinations
endpoint.capabilities.outbound.issues
array of string
endpoint.dependencies
array of object
The dependencies of the endpoint. It shows the connectors that the endpoint is connected to.
Afficher les attributs enfants
endpoint.dependencies.type
string
Possible values: connector
endpoint.dependencies.connectorId
string
obligatoire
endpoint.dependencies.connectorTemplateRef
string
obligatoire
endpoint.dependencies.capabilities
array of string
endpoint.issues
array of string
endpoint.provisioningStatus
string
obligatoire
Possible values: provisioned, provisioning, deprovisioned, deprovisioning
endpoint.whatsApp
object
WhatsApp pre-verification details for this endpoint, if applicable. Only present for long code numbers from WhatsApp-capable providers.
Afficher les attributs enfants
endpoint.whatsApp.whatsAppId
string
endpoint.whatsApp.status
string
WhatsApp number status
Possible values: unknown, already-exists, installed, verified, not-verified, expired
endpoint.whatsApp.stage
string
endpoint.whatsApp.attempt
integer
endpoint.whatsApp.nextAttemptAt
string
endpoint.whatsApp.verificationExpiresAt
string
endpoint.whatsApp.requestedCodeAt
string
endpoint.whatsApp.createdAt
string
endpoint.whatsApp.updatedAt
string
endpoint.createdAt
string
obligatoire
endpoint.updatedAt
string
obligatoire
Exemple de code
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/numbers-long-code/{longCodeNumberId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'