---
title: "Report a confirmed-fraud value"
method: POST
path: "/v1/report"
tags: ["Reputation"]
---

# Report a confirmed-fraud value

`POST /v1/report`

## Request

- Base URL: `https://www.layercall.com`
- URL: `https://www.layercall.com/v1/report`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Feeds our own reputation network. Counts as one lookup per value. Test-mode keys are refused so fixtures never reach shared data.

## Request body

- object
  - `kind` 'ip' | 'email' | 'domain' | 'phone', required
  - `value` string
  - `values` string[]

## Response `200`

Success

- object
  - `processing_time_sec` number
  - `reported` integer
  - `request_id` string
  - `results` object[]
    - `abuse_reports` integer
    - `kind` string
  - `skipped` unknown[]
    - unknown

## Other responses

- `400`: Invalid input
- `402`: Quota exceeded, or account paused after a failed payment
- `403`: Invalid or revoked API key
- `429`: Rate limited — honour Retry-After

---

[API](https://skmtc.dev/layercall/apis/layercall-api.md) · [All operations](https://skmtc.dev/layercall/apis/layercall-api/llms.txt) · [OpenAPI document](https://skmtc.dev/layercall/apis/layercall-api/revisions/b1258307dc91?raw)