---
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`

Returns background jobs that operate on phone numbers. Filter by job type, target phone numbers, or job status, and sort by creation time. Multiple phone-number or status values use OR semantics within that filter; different filter categories use AND semantics. Results include pagination metadata.

## Query parameters

- `page` object
  - `size` integer — The size of the page
  - `number` integer — The page number to load
- `sort` 'created_at'
- `filter` object
  - `type` 'update_emergency_settings' | 'delete_phone_numbers' | 'update_phone_numbers' — Identifies the type of the background job.
  - `phone_number` union — Returns jobs that targeted any of the supplied account-owned phone numbers. Values beginning with `+` must contain 1 to 20 digits after the plus sign. The 10-value limit is enforced before duplicate values are removed. Unmatched or non-account-owned identifiers return an empty result. Phone-number filtering must be enabled for the account.
    - string — One E.164 phone number or Telnyx Phone Number ID, or a comma-separated list of up to 10 values.
    - string[] — Up to 10 E.164 phone numbers or Telnyx Phone Number IDs. Use repeated `filter[phone_number][]` parameters.
  - `status` string[] — Returns jobs with any of the supplied statuses. Use repeated `filter[status][]` parameters; scalar and comma-separated status values are not accepted.

## 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
    - `total_results` integer
    - `page_number` integer
    - `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

## Changes

> 82 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd` — 4 breaking, 4 warning, 8 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `400`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `401`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `422`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `500`
  - …12 more
- **2026-08-17** `1571b0380bd7` — 12 breaking, 4 info
  - the response property `errors/items/code` became optional for the status `400`
  - the response property `errors/items/code` became optional for the status `401`
  - the response property `errors/items/code` became optional for the status `422`
  - the response property `errors/items/code` became optional for the status `500`
  - …12 more
- …earlier changes not shown

[Full history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/phone_numbers/jobs/get.md)

---

[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/16bfa298dc71?raw)