v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Number Portout

Update Status

Authorize or reject portout request

patch/portouts/{id}/{status}

Path parameters

idstring uuid required

Portout id

status'authorized' | 'rejected-pending' required

Updated portout status

Request body

host_messagingboolean

Indicates whether messaging services should be maintained with Telnyx after the port out completes

reasonstring required

Provide a reason if rejecting the port out request

Example request

{
  "reason": "I do not recognize this transaction"
}

Response

Portout Response

Example response

{
  "data": {
    "authorized_name": "McPortersen",
    "carrier_name": "test",
    "city": "Chicago",
    "created_at": "2018-02-02T22:25:27.521Z",
    "current_carrier": "telnyx",
    "end_user_name": "McPortersen",
    "foc_date": "2018-02-02T22:25:27.521Z",
    "id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
    "inserted_at": "2018-02-02T22:25:27.521Z",
    "lsr": [
      "https://example.com/files/lsr.pdf"
    ],
    "phone_numbers": [
      "+35312345678"
    ],
    "pon": "00000000",
    "record_type": "portout",
    "rejection_code": 1002,
    "requested_foc_date": "2018-02-02T22:25:27.521Z",
    "service_address": "000 Example Street",
    "spid": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
    "state": "IL",
    "status": "rejected",
    "support_key": "PO_764725",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "user_id": "7865816a-ee85-4e50-b19e-52983dcc6d4a",
    "vendor": "0e66ed3b-37e6-4fed-93d6-a30ce2493661",
    "zip": "00000"
  }
}