The BusinessPhoneNumber Object

A business-owned phone number with enabled features and lifecycle metadata.

Properties

NameDescriptionTypeRequired
uidUnique identifier for the phone number record.string
business_uidUnique identifier of the business that owns this phone number.string
phone_numberThe complete phone number in E.164 format without formatting (e.g., "12127654321"). This is the actual phone number that was purchased from the telecom provider.string
country_codeISO 3166-1 alpha-2 country code indicating the country where the phone number is registered (e.g., "US" for United States, "CA" for Canada).string
featuresList of telephony features to enable for this phone number, (e.g., ["VOICE", "SMS"]).array of strings
statusCurrent operational status of the phone number.string (enum: active, inactive, suspended)
created_atThe creation date and time of the phone number record.string
updated_atUpdated date and time of the phone number record.string

Example

JSON

{
  "uid": "number123",
  "business_uid": "business123abc",
  "phone_number": "12127654321",
  "country_code": "US",
  "features": [
    "VOICE",
    "SMS"
  ],
  "status": "active",
  "created_at": "2024-01-01T09:00:00Z",
  "updated_at": "2024-03-20T12:34:56Z"
}