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

# Report API (FELCA)

> Public channel to report improper messages via POST /v1/report, no API Key.

<Tip>
  This is the platform's **required suggestion box**: anyone can report abuse without an account, as required by Law 14.230/2021 (FELCA).
</Tip>

## In short

* Public endpoint **`POST /v1/report`**, no `Authorization`.
* Form for end users: **notifique.dev/report**.
* Accepted channels: `email`, `whatsapp`, `telegram`, `sms`, `rcs`.
* Description between **50 and 5000** characters (HTML stripped).
* Per-IP rate limit: **5/min** and **20/h**.

## When to use?

| Who                            | What to do                                                           |
| ------------------------------ | -------------------------------------------------------------------- |
| **End user**                   | Form at notifique.dev/report (recommended)                           |
| **System** forwarding a report | `POST /v1/report` (this contract)                                    |
| Notifique integrator           | Not for sending messages, only to expose a channel if it makes sense |

## Request fields

| Field           | Required | Description                                   |
| --------------- | -------- | --------------------------------------------- |
| **channel**     | yes      | `email`, `whatsapp`, `telegram`, `sms`, `rcs` |
| **contact**     | yes      | Valid reporter email                          |
| **description** | yes      | **50–5000** characters                        |

## Error responses

| HTTP | `code`                | When                                                        |
| ---- | --------------------- | ----------------------------------------------------------- |
| 400  | `BAD_REQUEST`         | Invalid channel, invalid email, or description out of range |
| 429  | `RATE_LIMIT_EXCEEDED` | Per-IP limit                                                |
| 503  | `SERVICE_UNAVAILABLE` | Temporary unavailability                                    |
| 500  | `INTERNAL_ERROR`      | Failed to save                                              |

General pattern: [Error responses](/guides/conceitos/resposta-de-erros).

## Example

```http theme={null}
POST https://api.notifique.dev/v1/report
Content-Type: application/json
```

```json theme={null}
{
  "channel": "sms",
  "contact": "user@example.com",
  "description": "Unsolicited commercial message to a number on an opt-out list; I request identification of the responsible party per the report policy."
}
```

**200** saved:

```json theme={null}
{
  "success": true,
  "message": "Report received. Thank you."
}
```

<Note>
  Do not send `Authorization`. The endpoint is public by legal and operational design.
</Note>

***

## Next steps

* [Trust Factor](/guides/workspaces/trust-factor): workspace reputation
* [Security and reliability](/guides/conceitos/seguranca-e-confiabilidade)
* [Workspaces](/guides/workspaces/index)