---
title: "Record and reconcile one controlled settlement observation"
method: POST
path: "/api/v1/settlements/observations"
tags: ["Commerce"]
---

# Record and reconcile one controlled settlement observation

`POST /api/v1/settlements/observations`

## Request

- Base URL: `https://axiomrelay.io`
- URL: `https://axiomrelay.io/api/v1/settlements/observations`
- Auth: none declared. Required headers: `Idempotency-Key`

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `expectationId` string, required
  - `recipient` string, required
  - `amount` string, required
  - `asset` string, required
  - `network` string, required
  - `paymentReference` string, required
  - `finality` 'PENDING' | 'CONFIRMED' | 'REVERSED', required

## Response `200`

Idempotent replay

## Other responses

- `202`: Observation recorded and deterministically reconciled
- `409`: Idempotency conflict

---

[API](https://skmtc.dev/axiomrelay/apis/axiom-relay-control-plane-api.md) · [All operations](https://skmtc.dev/axiomrelay/apis/axiom-relay-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/axiomrelay/apis/axiom-relay-control-plane-api/revisions/64ba55463cd2?raw)