OverviewProductsPlatformsAPI ReferenceResources
Phone Numbers

Get declined requirements

GEThttps://zernio.com/api/v1/phone-numbers/{id}/remediate

For a number in regulatory_declined, returns ONLY the requirements the reviewer flagged declined, as a form spec (same shape as the KYC form GET).

The customer fixes only those, because Telnyx supports correcting a declined requirement group and re-submitting it (no new number/group).

It falls back to the full spec if the provider exposes no per-requirement flags.

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Path parameters

idstringRequired

Phone number record ID.

Responses

Success· the request worked

Errors· the request failed

Create a hosted KYC link

Create a single-use, 7-day hosted KYC link that your end customer completes WITHOUT a Zernio login. Useful when the person who holds the ID and address is not your team. They fill the regulated verification on a Zernio-hosted page, and the number provisions under YOUR account once they submit. Only regulated (KYC) countries are valid: a country that does not require KYC returns 400. ### Choosing the number - `numberType` (`local`, `mobile`, `national`, `toll_free`): which of the country's offered types the shared form collects KYC for and eventually orders. Omitted, it defaults to the country's default type, which may be `national` and therefore have no inventory in a geographic area code. - `areaCode` (NDC digits): constrains the eventual order to a specific area. It is validated against the chosen `numberType`. ### Branding and completion - White-label the page with `branding` (your company name, logo, brand color). - Supply `redirect_url` to send the end customer back to your own site after a successful submit (completion params are appended; see below). - Listen for the `whatsapp.number.kyc_submitted` webhook to react when the form is completed.

Resubmit a declined number

Submit corrected values/documents for the declined requirement(s). We PATCH them onto the SAME requirement group and re-submit it for approval; the number goes `regulatory_declined` → `pending_regulatory`. No new number and no new billing. Body shape matches the KYC submit (values / documents / address). Send only the corrected fields.

GET/v1/phone-numbers/{id}/remediate
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.phonenumbers.getPhoneNumberRemediation({  path: {    id: 'abc123',  },});console.log(data);
{  "country": "string",  "numberType": "string",  "declineReason": "string",  "fields": [    {}  ]}
OpenAPI specification
Was this page helpful?