---
title: "Lists the phone numbers jobs"
method: GET
path: "/phone_numbers/jobs"
tags: ["Bulk Phone Number Operations"]
---

# Lists the phone numbers jobs

`GET /phone_numbers/jobs`

## Query parameters

- `sort` 'created_at'
- `filter` object
  - `type` 'update_emergency_settings' | 'delete_phone_numbers' | 'update_phone_numbers' — Identifies the type of the background job.
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response with a list of phone numbers background jobs.

- object
  - `data` PhoneNumbersJob[]
    - `id` string, uuid — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'expired' — Indicates the completion status of the background update.
    - `type` 'update_emergency_settings' | 'delete_phone_numbers' | 'update_phone_numbers' — Identifies the type of the background job.
    - `etc` string, date-time — ISO 8601 formatted date indicating when the estimated time of completion of the background job.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.
    - `phone_numbers` PhoneNumbersJobPhoneNumber[]
      - `phone_number` string — The phone number in e164 format.
      - `id` string — The phone number's ID
    - `successful_operations` PhoneNumbersJobSuccessfulOperation[]
      - `phone_number` string — The phone number in e164 format.
      - `id` string — The phone number's ID
    - `pending_operations` PhoneNumbersJobPendingOperation[]
      - `phone_number` string — The phone number in e164 format.
      - `id` string — The phone number's ID
    - `failed_operations` PhoneNumbersJobFailedOperation[]
      - `phone_number` string — The phone number in e164 format.
      - `id` string — The phone number's ID
      - `errors` NumbersError[]
        - `code` string
        - `title` string
        - `detail` string
        - `source` object
          - `pointer` string — JSON pointer (RFC6901) to the offending entity.
          - `parameter` string — Indicates which query parameter caused the error.
        - `meta` object
          - `url` string — URL with additional information on the error.
  - `meta` PaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — Unexpected 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)