---
title: "Respond to the regulatory reviewer (message + corrections)"
method: POST
path: "/v1/phone-numbers/{id}/remediate/respond"
tags: ["Phone Numbers"]
---

# Respond to the regulatory reviewer (message + corrections)

`POST /v1/phone-numbers/{id}/remediate/respond`

Send a single response to the reviewer on a number awaiting remediation:
a free-text message and/or corrected requirement documents, in one call.
If corrections are present they are PATCHed onto the requirement group and
re-submitted (the number goes back to "in review"); if a message or file
attachments are present they are posted to the reviewer's comment thread.
When both are present, your message is the thread comment and the resubmit
drives the state change. At least one of message, corrections, or
attachments is required. `documents` correct requirement slots; `attachments`
are loose files (their links are added to your message).

## Path parameters

- `id` string, required

## Request body

- object
  - `message` string — Your message to the reviewer.
  - `documents` object[] — Corrected requirement documents, each keyed to its requirement.
    - `requirementId` string, required
    - `filename` string
    - `base64` string — Base64-encoded file bytes (or supply documentId instead).
    - `documentId` string — Id of a document already uploaded out-of-band.
  - `address` object — A corrected address record, keyed to its requirement.
  - `entityType` 'individual' | 'business' | 'null', nullable
  - `attachments` object[] — Loose files (PDF/JPG/PNG/WEBP, max 10 MB each) whose links are added to your message.
    - `filename` string, required
    - `base64` string, required — Base64-encoded file bytes.

## Response `200`

Response sent.

- object
  - `status` 'resubmitted' | 'replied' — `resubmitted` when corrections were submitted, `replied` when it was message-only.
  - `posted` boolean — Whether a message/attachments were posted to the reviewer.
  - `phoneNumber` object
    - `id` string
    - `status` string
  - `siblingsResubmitted` integer — Other numbers on the same registration the correction fanned out to.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Number not found
- `409` — Number's registration is held under our own carrier registration; nothing for you to correct.
- `502` — Couldn't deliver your response to the reviewer; retry.

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)