Run a portability check

POST 
/portability_checks

Runs a portability check, returning the results immediately.

application/json

Body

required

phone_numbers string[]

The list of +E.164 formatted phone numbers to check for portability

201: PortabilityCheck Response

application/json

• Schema
• Example (from schema)

Schema

data

object[]

Array [

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

]

{
  "data": [
    {
      "record_type": "portability_check_result",
      "fast_portable": true,
      "not_portable_reason": "No coverage",
      "phone_number": "+13125550123",
      "portable": true
    }
  ]
}

401: Unauthorized

422: Unprocessable entity. Check message field in response for details.

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/portability_checks' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "phone_numbers": [
    "+13035550000",
    "+13035550001",
    "+13035550002"
  ]
}'

Response samples

• 201

---

{
  "data": [
    {
      "record_type": "portability_check_result",
      "fast_portable": true,
      "not_portable_reason": "No coverage",
      "phone_number": "+13125550123",
      "portable": true
    }
  ]
}