GET /v1/phone-verification/status/:user_id
Purpose
Section titled “Purpose”Read current phone verification status used by send gating.
Auth requirement
Section titled “Auth requirement”Bearer API key (Authorization: Bearer <key>).
Request schema
Section titled “Request schema”Path parameter:
user_id(string)
No request body.
Response schema
Section titled “Response schema”200 OK
{ "user_id": "string", "status": "unverified|pending|verified", "verified_at": "ISO-8601|null", "phone_last4": "string|null", "updated_at": "ISO-8601"}Error cases
Section titled “Error cases”401 unauthorized: invalid/inactive API key.404 not_found: user does not exist for your tenant.
Curl example
Section titled “Curl example”curl -H "Authorization: Bearer $ETN_API_KEY" \ "$GATEWAY_BASE_URL/v1/phone-verification/status/user_123"Notes and limits
Section titled “Notes and limits”- Full phone number is never returned.
- Tenant isolation is enforced by API key ownership.