---
title: "Show a port-out event"
method: GET
path: "/portouts/events/{id}"
tags: ["Number Portout"]
---

# Show a port-out event

`GET /portouts/events/{id}`

Show a specific port-out event.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful response

- object
  - `data` union
    - object
      - `id` string, uuid — Uniquely identifies the event.
      - `event_type` 'portout.status_changed' | 'portout.foc_date_changed' | 'portout.new_comment' — Identifies the event type
      - `portout_id` string, uuid — Identifies the port-out 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 portout.status_changed event
        - `id` string, uuid — Identifies the port out that was moved.
        - `status` 'pending' | 'authorized' | 'ported' | 'rejected' | 'rejected-pending' | 'canceled' — The new status of the port out.
        - `phone_numbers` string[] — Phone numbers associated with this port-out order
        - `carrier_name` string — Carrier the number will be ported out to
        - `spid` string — The new carrier SPID.
        - `user_id` string, uuid — Identifies the user that the port-out order belongs to.
        - `subscriber_name` string — The name of the port-out's end user.
        - `rejection_reason` string, nullable — The reason why the order is being rejected by the user. If the order is authorized, this field can be left null
        - `attempted_pin` string — The PIN that was attempted to be used to authorize the port out.
      - `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` 'portout.status_changed' | 'portout.foc_date_changed' | 'portout.new_comment' — Identifies the event type
      - `portout_id` string, uuid — Identifies the port-out 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 portout.new_comment event
        - `id` string, uuid — Identifies the comment that was added to the port-out order.
        - `portout_id` string, uuid — Identifies the port-out order that the comment was added to.
        - `user_id` string, uuid — Identifies the user that added the comment.
        - `comment` string — The body of the comment.
      - `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` 'portout.status_changed' | 'portout.foc_date_changed' | 'portout.new_comment' — Identifies the event type
      - `portout_id` string, uuid — Identifies the port-out 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 portout.foc_date_changed event
        - `id` string, uuid — Identifies the port-out order that have the FOC date changed.
        - `user_id` string — Identifies the organization that port-out order belongs to.
        - `foc_date` string, date-time — ISO 8601 formatted date indicating the new FOC date.
      - `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-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)
