v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-041,1941,9384.1 MB
Porting Orders

Create an associated phone number

Creates a new associated phone number for a porting order. This is used for partial porting in GB to specify which phone numbers should be kept or disconnected.

post/porting_orders/{porting_order_id}/associated_phone_numbers

Path parameters

porting_order_idstring uuid required

Identifies the Porting Order associated with the phone number

Request body

action'keep' | 'disconnect' required

Specifies the action to take with this phone number during partial porting.

Example request

{
  "action": "keep",
  "phone_number_range": {
    "end_at": "+441234567899",
    "start_at": "+441234567890"
  }
}

Response

Successful response

Example response

{
  "data": {
    "action": "keep",
    "country_code": "GB",
    "created_at": "2021-03-19T10:07:15.527Z",
    "id": "f24151b6-3389-41d3-8747-7dd8c681e5e2",
    "phone_number_range": {
      "end_at": "+441234567899",
      "start_at": "+441234567890"
    },
    "phone_number_type": "local",
    "porting_order_id": "a24151b6-3389-41d3-8747-7dd8c681e5e2",
    "record_type": "porting_associated_phone_number",
    "updated_at": "2021-03-19T10:07:15.527Z"
  }
}