Get declined requirements
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
API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
Path parameters
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.