List flow responses
List the responses customers submitted when completing a flow (parsed from the
nfm_reply messages received via webhook), newest first. Scope to a single flow
with flowId — this matches responses whose flow_token carries the <flowId>:
prefix that Zernio stamps on auto-generated tokens at send time. Responses sent
with a custom integrator-supplied flow_token are not attributed to a flow.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
WhatsApp social account ID
Scope to responses for this flow
Max responses to return
50value <= 200Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.whatsappflows.listWhatsAppFlowResponses({ query: { accountId: 'account_abc123', },});console.log(data);{
"responses": [
{
"id": "string",
"receivedAt": "2019-08-24T14:15:22Z",
"from": "string",
"senderName": "string",
"conversationId": "string",
"flowToken": "string",
"data": {},
"raw": "string"
}
]
}{
"error": "Unauthorized"
}Pre-validate a regulated-number KYC address (Tier 4) POST
Optional early check for the address step of a Tier 4 (end-user identity) registration: validates a postal address for deliverability BEFORE the full KYC submit, so it can be corrected before any documents are uploaded. The full submit (POST /v1/whatsapp/phone-numbers/kyc) re-validates the address, so this call is purely a fast feedback path and skipping it is safe. Only the postal address is sent (no documents, no gov-ID fields). A region (`administrative_area`) is required by the validator; when it is omitted the pre-check is skipped and `{ ok: true, skipped: true }` is returned (the final submit still validates).
List flow versions GET
List the flow's version history (the clone lineage Zernio tracks, since Meta has no native versioning), newest version first. Each entry is enriched with the version's live name and status from Meta. A flow with no lineage returns just itself as version 1.