Phone Numbers

Check portability

Changed on

Pre-flight portability check: whether each number can be ported in, whether it qualifies for FastPort, and its current carrier and line type where the carrier lookup knows them, BEFORE the user commits to a port order (LOA, invoice, service address). Read-only; creates no order and bills nothing.

Works without an API key for one number per request. Keyless calls are what the checker at https://zernio.com/port-your-number makes: they must come from that page (a browser bot check rejects scripted callers with 401), are limited per IP (3 a minute, 10 a day) and by a shared daily budget (429 once spent), because each check runs a paid carrier lookup. Each portable keyless result carries a claimId and a claimUrl: a signup link that opens the dashboard's port form with the number filled in. Send an API key to check up to 50 numbers without those limits.

post/v1/phone-numbers/port-in/check

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/phone-numbers/port-in/check
  • Auth: one of:
    • none
    • HTTP bearer

Request body

phoneNumbersstring[] required

E.164 numbers to check, e.g. +13035550000. At most one without an API key.

claimLinksboolean

true adds claimId and claimUrl to portable results even when you send an API key, e.g. to hand a user a signup link that opens the port form with their number.

Response

Per-number portability.

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status