---
title: "Run a portability check"
method: POST
path: "/portability_checks"
tags: ["Phone Number Porting"]
---

# Run a portability check

`POST /portability_checks`

Runs a portability check, returning the results immediately.

## Request body

- object
  - `phone_numbers` string[] — The list of +E.164 formatted phone numbers to check for portability

## Response `201`

PortabilityCheck Response

- object
  - `data` PortabilityCheckDetails[]
    - `record_type` string — Identifies the type of the resource.
    - `fast_portable` boolean — Indicates whether this phone number is FastPort eligible
    - `not_portable_reason` string — If this phone number is not portable, explains why. Empty string if the number is portable.
    - `phone_number` string — The +E.164 formatted phone number this result is about
    - `portable` boolean — Indicates whether this phone number is portable

## Other responses

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

---

[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)
