---
title: "Show a porting event"
method: GET
path: "/porting/events/{id}"
tags: ["Porting Orders"]
---

# Show a porting event

`GET /porting/events/{id}`

Show a specific porting event.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful response

- object
  - `data` union
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.deleted' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` object
        - `id` string, uuid — Identifies the porting order that was deleted.
        - `customer_reference` string — Identifies the customer reference associated with the porting order.
        - `deleted_at` string, date-time — ISO 8601 formatted date indicating when the porting order was deleted.
        - `record_type` string — Identifies the type of the resource.
        - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
        - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.messaging_changed' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` object — The webhook payload for the porting_order.messaging_changed event
        - `id` string, uuid — Identifies the porting order that was moved.
        - `customer_reference` string — Identifies the customer reference associated with the porting order.
        - `support_key` string — Identifies the support key associated with the porting order.
        - `messaging` object — The messaging portability status of the porting order.
          - `messaging_capable` boolean — Indicates whether the porting order is messaging capable.
          - `enable_messaging` boolean — Indicates whether Telnyx will port messaging capabilities from the losing carrier. If false, any messaging capabilities will stay with their current provider.
          - `messaging_port_status` 'not_applicable' | 'pending' | 'activating' | 'exception' | 'canceled' | 'partial_port_complete' | 'ported' — Indicates the messaging port status of the porting order.
          - `messaging_port_completed` boolean — Indicates whether the messaging port is completed.
      - `record_type` string — Identifies the type of the resource.
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.status_changed' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` object — The webhook payload for the porting_order.status_changed event
        - `id` string, uuid — Identifies the porting order that was moved.
        - `customer_reference` string — Identifies the customer reference associated with the porting order.
        - `status` PortingOrderStatus — Porting order status
          - `details` PortingOrdersExceptionType[] — A list of 0 or more details about this porting order's status
            - `code` 'ACCOUNT_NUMBER_MISMATCH' | 'AUTH_PERSON_MISMATCH' | 'BTN_ATN_MISMATCH' | 'ENTITY_NAME_MISMATCH' | 'FOC_EXPIRED' | 'FOC_REJECTED' | 'LOCATION_MISMATCH' | 'LSR_PENDING' | 'MAIN_BTN_PORTING' | 'OSP_IRRESPONSIVE' | 'OTHER' | 'PASSCODE_PIN_INVALID' | 'PHONE_NUMBER_HAS_SPECIAL_FEATURE' | 'PHONE_NUMBER_MISMATCH' | 'PHONE_NUMBER_NOT_PORTABLE' | 'PORT_TYPE_INCORRECT' | 'PORTING_ORDER_SPLIT_REQUIRED' | 'POSTAL_CODE_MISMATCH' | 'RATE_CENTER_NOT_PORTABLE' | 'SV_CONFLICT' | 'SV_UNKNOWN_FAILURE' — Identifier of an exception type
            - `description` string — Description of an exception type
          - `value` 'draft' | 'in-process' | 'submitted' | 'exception' | 'foc-date-confirmed' | 'ported' | 'cancelled' | 'cancel-pending' — The current status of the porting order
        - `support_key` string — Identifies the support key associated with the porting order.
        - `updated_at` string, date-time — ISO 8601 formatted date indicating when the porting order was moved.
        - `webhook_url` string — The URL to send the webhook to.
      - `record_type` string — Identifies the type of the resource.
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.new_comment' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` object — The webhook payload for the porting_order.new_comment event
        - `porting_order_id` string, uuid — Identifies the porting order that the comment was added to.
        - `support_key` string — Identifies the support key associated with the porting order.
        - `comment` object — The comment that was added to the porting order.
          - `id` string, uuid — Identifies the comment.
          - `body` string — The body of the comment.
          - `user_id` string, uuid — Identifies the user that create the comment.
          - `user_type` 'user' | 'admin' | 'system' — Identifies the type of the user that created the comment.
          - `inserted_at` string, date-time — ISO 8601 formatted date indicating when the comment was created.
      - `record_type` string — Identifies the type of the resource.
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.split' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` object — The webhook payload for the porting_order.split event
        - `from` object — The porting order that was split.
          - `id` string, uuid — Identifies the porting order that was split.
        - `to` object — The new porting order that the phone numbers was moved to.
          - `id` string, uuid — Identifies the porting order that was split.
        - `porting_phone_numbers` object[] — The list of porting phone numbers that were moved to the new porting order.
          - `id` string, uuid — Identifies the porting phone number that was moved.
      - `record_type` string — Identifies the type of the resource.
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'porting_order.loa_updated' | 'porting_order.sharing_token_expired' — Identifies the event type
      - `porting_order_id` string, uuid — Identifies the porting order associated with the event.
      - `available_notification_methods` string[] — Indicates the notification methods used.
      - `payload_status` 'created' | 'completed' — The status of the payload generation.
      - `payload` unknown
      - `record_type` string — Identifies the type of the resource.
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)