---
title: "POST /v2/merchants/:id/reporting/health"
method: POST
path: "/v2/merchants/{id}/reporting/health"
tags: ["reporting"]
---

# POST /v2/merchants/:id/reporting/health

`POST /v2/merchants/{id}/reporting/health`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/v2/merchants/{id}/reporting/health`
- Auth: API key in header `AIFP-Merchant-Secret`

Reporting v2: observations never authorize payments or access. Current scope and explicit coverage; no-store. Default-off operator flag; independent approval and deployment are separate.

## Path parameters

- `id` string, required: Server-issued identifier

## Request body

- ReportingHealth
  - `version` 2, required
  - `producer_id` string, uuid, required
  - `sequence` string, required
  - `at` string, date-time, required
  - `supported` string[], required
  - `pending` integer, required
  - `dropped` string, required
  - `retries` string, required
  - `last_error` 'none' | 'network' | 'timeout' | 'auth' | 'rejected' | 'storage' | 'queue_full' | 'retry_exhausted', required

## Response `200`

Evidence-bound reporting response

- ReportingHealthAck
  - `version` 2, required
  - `duplicate` boolean, required

## Other responses

- `400`: Safe reporting error; no payload or credential echo
- `401`: Safe reporting error; no payload or credential echo
- `403`: Safe reporting error; no payload or credential echo
- `404`: Safe reporting error; no payload or credential echo
- `409`: Safe reporting error; no payload or credential echo
- `410`: Safe reporting error; no payload or credential echo
- `413`: Safe reporting error; no payload or credential echo
- `422`: Safe reporting error; no payload or credential echo
- `429`: Safe reporting error; no payload or credential echo
- `503`: Safe reporting error; no payload or credential echo

---

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