---
title: "Report an answer you believe is wrong (support portal intake)"
method: POST
path: "/v1/report"
---

# Report an answer you believe is wrong (support portal intake)

`POST /v1/report`

## Request

- Base URL: `https://api.hlaverify.com`
- URL: `https://api.hlaverify.com/v1/report`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Files one support report: a verdict, normalization or lookup that looks wrong, a docs page that disagrees with the API, an outdated release, or a question. Every report is rerun against the live API and the IPD-IMGT/HLA reference data, and a person confirms any error before it is published; a confirmed error is fixed and listed with the release that fixed it. Returns an id to follow it with GET /v1/report/{id} or at https://hlaverify.com/support?id=... . Do not include patient identifiers of any kind, names included: obvious ones (record-number and DOB labels, SSNs, US-format dates) are refused with 422 and nothing is stored, and a name cannot be detected. Stores what you send plus a timestamp, CF-IPCountry and the live release, and no IP address, in a store separate from API keys. At most 20 reports a day per IP. Not billable against the daily quota, but rate limited like every other /v1/ route (60 requests/minute per IP without a key).

## Request body

- object
  - `kind` 'wrong_result' | 'docs_mismatch' | 'outdated_release' | 'question' | 'other'
  - `endpoint` string
  - `input` string, required: The HLA names or request you sent. No patient identifiers.
  - `received` string: What the API answered.
  - `expected` string, required: What you expected instead.
  - `details` string
  - `email` string: Optional; where we reply.
  - `request_id` string
  - `source` string: Free-text hint: site, mcp, docs.

## Response `200`

recorded

- object
  - `ok` boolean, required
  - `id` string, required
  - `status` 'received', required
  - `status_url` string, required
  - `message` string, required
  - `release` string, required

## Other responses

- `422`: a missing or empty required field, an unknown kind, an oversized field, an invalid email, or something shaped like a patient identifier
- `429`: rate limited: 60 req/min per IP, or more than 20 reports today from this IP (/v1/report does not consume daily quota)
- `503`: the report store is not available on this deployment

---

[API](https://skmtc.dev/hlaverify/apis/hla-verify.md) · [All operations](https://skmtc.dev/hlaverify/apis/hla-verify/llms.txt) · [OpenAPI document](https://skmtc.dev/hlaverify/apis/hla-verify/revisions/40cd5e7d134d?raw)