> ## Documentation Index
> Fetch the complete documentation index at: https://developers.senderz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reject registration

> Reject a Sender ID registration for your network.

**Required permission:** `operator:write`

Rejects a registration that is currently in `pending_operator_review` or `resubmitted` status. The submitting brand or aggregator is notified with the rejection reason.

Returns `409 Conflict` if the registration is not in an actionable status.

## Path parameters

<ParamField path="registration_id" type="string" required>
  The operator registration ID (e.g. `opreg_e5f6g7h8`).
</ParamField>

## Request body

<ParamField body="reason" type="string" required>
  Structured rejection reason. One of: `brand_mismatch`, `use_case_unclear`, `duplicate_sid`, `restricted_term`, `compliance_concern`, `insufficient_evidence`, `other`.
</ParamField>

<ParamField body="detail" type="string" required>
  Human-readable explanation of the rejection. This is shared with the submitting brand or aggregator.
</ParamField>

<ParamField body="notes" type="string">
  Optional internal notes. Not visible to the submitting brand or aggregator.
</ParamField>

## Example

```bash theme={null}
curl -X POST https://api.senderz.ai/v1/operator-registrations/opreg_e5f6g7h8/reject \
  -H "Authorization: Bearer sz_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "use_case_unclear",
    "detail": "Use case description does not specify the type of messages to be sent. Please provide specific examples of message content.",
    "notes": "Brand is verified but use case needs more detail before we can approve."
  }'
```

## Response

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "data": {
      "id": "opreg_e5f6g7h8",
      "sender_id": "SecurBank",
      "status": "rejected",
      "rejection": {
        "reason": "use_case_unclear",
        "detail": "Use case description does not specify the type of messages to be sent. Please provide specific examples of message content."
      },
      "rejected_at": "2026-07-17T15:15:00+10:00",
      "rejected_by": "operator_api_key"
    },
    "meta": {
      "request_id": "req_op004",
      "timestamp": "2026-07-17T15:15:00+10:00"
    }
  }
  ```
</ResponseExample>