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

# Respond to the regulatory reviewer (message + corrections)

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

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/messaging/phone-numbers/{id}/remediate/respond`
- Auth: HTTP bearer

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).


**Billing:** Request; paid actions are priced in credits (see GET /v1/messaging/prices) · **Rate limit:** 60/min

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string
- `X-Tag` string

## Request body

- object
  - `address` object: A corrected address record, keyed to its requirement.
  - `message` string: Your message to the reviewer.
  - `documents` object[]: Corrected requirement documents, each keyed to its requirement.
    - `base64` string: Base64-encoded file bytes (or supply documentId instead).
    - `filename` string
    - `issuedAt` string, date: Date printed on the document (YYYY-MM-DD), for slots the regulator windows such as proof of address. The pre-submit review trusts it over its own read of the PDF.
    - `documentId` string: Id of a document already uploaded out-of-band.
    - `requirementId` string, required
  - `entityType` 'individual' | 'business' | 'null', nullable
  - `attachments` object[]: Loose files (PDF/JPG/PNG/WEBP, max 10 MB each) whose links are added to your message.
    - `base64` string, required: Base64-encoded file bytes.
    - `filename` string, required

## Response `200`

Completed

- object
  - `id` string: Execution id — stable across internal retries; use it with GET /v1/executions/{id}
  - `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
  - `operation` string
  - `tag` string, nullable: Your X-Tag, if sent
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `output` object: Operation result (see each operation). While a Studio render is processing: `stage` (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), `phase` (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), `progress` (a percent, 0–100) and `progress_fraction` (0–1), `eta_seconds` (seconds left, never below 0) and `estimate_seconds`
    - `posted` boolean: Whether a message/attachments were posted to the reviewer.
    - `status` 'resubmitted' | 'replied': `resubmitted` when corrections were submitted, `replied` when it was message-only.
    - `phoneNumber` object
      - `id` string
      - `status` string
    - `siblingsResubmitted` integer: Other numbers on the same registration the correction fanned out to.
  - `error` string, nullable
  - `usage` object
    - `credits_charged` number, nullable
    - `credits_reserved` number
    - `estimated_credits` number
    - `cost_source` 'provider_reported' | 'calculated' | 'estimated' | 'null', nullable
    - `provider_usage` object, nullable: Normalised consumption, e.g. { VIDEO_SECOND: 22.4 }
  - `balance` object
    - `available` number
    - `reserved` number

## Other responses

- `400`: Invalid input
- `402`: Insufficient credits / project budget
- `404`: Resource not found (or not yours)
- `429`: Rate limited
- `503`: Service temporarily paused

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)