---
title: "Retrieve a porting activation job"
method: GET
path: "/porting_orders/{id}/activation_jobs/{activationJobId}"
tags: ["Porting Orders"]
---

# Retrieve a porting activation job

`GET /porting_orders/{id}/activation_jobs/{activationJobId}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/porting_orders/{id}/activation_jobs/{activationJobId}`
- Auth: HTTP bearer

Returns the details of a single activation job for the porting order, including its current status.

## Path parameters

- `id` string, uuid, required
- `activationJobId` string, uuid, required

## Response `200`

Successful response

- object
  - `data` PortingOrdersActivationJob
    - `id` string, uuid: Uniquely identifies this activation job
    - `status` 'created' | 'in-process' | 'completed' | 'failed': Specifies the status of this activation job
    - `activation_type` 'scheduled' | 'on-demand': Specifies the type of this activation job
    - `activate_at` string, date-time: ISO 8601 formatted date indicating when the activation job should be executed. This time should be between some activation window.
    - `activation_windows` object[]: List of allowed activation windows for this activation job
      - `start_at` string, date-time: ISO 8601 formatted date indicating when the activation window starts
      - `end_at` string, date-time: ISO 8601 formatted date indicating when the activation window ends
    - `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 created.

## Other responses

- `401`: Unauthorized
- `422`: Unprocessable entity. Check message field in response for details.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)