Financial artifact API

List artifacts for a receipt

GET /v1/iso/messages/{rid}

This public route returns artifact records with message type, URL, optional hash and creation time.

Workflow-specific generators

The hosted OpenAPI exposes:

POST /v1/iso/camt029/{receipt_id}
POST /v1/iso/camt056/{receipt_id}
POST /v1/iso/pacs007/{receipt_id}
POST /v1/iso/pacs009/{receipt_id}
POST /v1/iso/refund

The operation bodies and authentication requirements differ. Generate a client from the live OpenAPI or inspect the corresponding schema before calling one.

These endpoints create records and files. They do not cancel, reverse, refund or transfer blockchain funds merely because the message name represents such a financial workflow. Any actual value movement requires a separate authorized payment or contract action.

Integrity handling

When an artifact record provides sha256, recompute it over the downloaded bytes. Do not assume every artifact returned by this route is inside the anchored evidence ZIP. In the validated x402 receipt, pain.002 and camt.054 were served after anchoring and were outside the ZIP committed by the anchor.

All files are ISO 20022-style artifacts. Institutional conformance requires separate validation against the target schema and usage rules.