curl -s -X POST \
  "https://engine.example.com/v1/external-statements?externalSourceId=fund-admin-nav" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instrumentId": "FUND",
    "kind": "nav",
    "businessDate": "2026-10-03",
    "asOf": "2026-10-03T16:00:00Z",
    "currency": "USD",
    "nav": {
      "official": 1.004,
      "indicative": null,
      "indicativeAsOf": null,
      "expiresAt": "2026-10-04T16:00:00Z",
      "ripcord": false
    }
  }'

// A client from OpenAPI Generator: see Build a client.
import {
  CanonicalStatementFromJSON,
  Configuration,
  ProblemFromJSON,
  ReconciliationApi,
  ResponseError,
} from "./nodeasset-client";

const api = new ReconciliationApi(new Configuration({
  basePath: "https://engine.example.com",
  accessToken: process.env.TOKEN,
}));

try {
  const answer = await api.createExternalStatement({
    externalSourceId: "fund-admin-nav",
    canonicalStatement: CanonicalStatementFromJSON({
      instrumentId: "FUND",
      kind: "nav",
      businessDate: "2026-10-03",
      asOf: "2026-10-03T16:00:00Z",
      currency: "USD",
      nav: {
        official: 1.004,
        indicative: null,
        indicativeAsOf: null,
        expiresAt: "2026-10-04T16:00:00Z",
        ripcord: false,
      },
    }),
  });
  console.log(answer);
} catch (e) {
  if (!(e instanceof ResponseError)) throw e;
  // A refusal is a problem; its type ends in the slug.
  const problem = ProblemFromJSON(await e.response.json());
  const slug = problem.type.split(":").pop();
  console.error(e.response.status, slug, problem.detail);
}

# A client from OpenAPI Generator: see Build a client.
import os
import sys

import nodeasset_client

config = nodeasset_client.Configuration(
    host="https://engine.example.com",
    access_token=os.environ["TOKEN"],
)
with nodeasset_client.ApiClient(config) as client:
    api = nodeasset_client.ReconciliationApi(client)
    try:
        answer = api.create_external_statement(
            external_source_id="fund-admin-nav",
            canonical_statement=nodeasset_client.CanonicalStatement.model_validate({
                "instrumentId": "FUND",
                "kind": "nav",
                "businessDate": "2026-10-03",
                "asOf": "2026-10-03T16:00:00Z",
                "currency": "USD",
                "nav": {
                    "official": 1.004,
                    "indicative": None,
                    "indicativeAsOf": None,
                    "expiresAt": "2026-10-04T16:00:00Z",
                    "ripcord": False,
                },
            }),
        )
        print(answer)
    except nodeasset_client.ApiException as e:
        # A refusal is a problem; its type ends in the slug.
        problem = nodeasset_client.Problem.from_json(e.body)
        slug = problem.type.rsplit(":", 1)[-1]
        print(e.status, slug, problem.detail, file=sys.stderr)

// A client from OpenAPI Generator: see Build a client.
import nodeasset.client.ApiClient;
import nodeasset.client.ApiException;
import nodeasset.client.api.ReconciliationApi;
import nodeasset.client.model.CanonicalStatement;
import nodeasset.client.model.Problem;

public class CreateExternalStatement {
  public static void main(String[] args) throws Exception {
    ApiClient client = new ApiClient();
    client.updateBaseUri("https://engine.example.com");
    client.setRequestInterceptor(builder ->
        builder.header("Authorization", "Bearer " + System.getenv("TOKEN")));
    ReconciliationApi api = new ReconciliationApi(client);

    try {
      var request = ReconciliationApi.APICreateExternalStatementRequest.newBuilder()
          .externalSourceId("fund-admin-nav")
          .canonicalStatement(client.getObjectMapper().readValue("""
              {
                "instrumentId": "FUND",
                "kind": "nav",
                "businessDate": "2026-10-03",
                "asOf": "2026-10-03T16:00:00Z",
                "currency": "USD",
                "nav": {
                  "official": 1.004,
                  "indicative": null,
                  "indicativeAsOf": null,
                  "expiresAt": "2026-10-04T16:00:00Z",
                  "ripcord": false
                }
              }
              """, CanonicalStatement.class))
          .build();
      var answer = api.createExternalStatement(request);
      System.out.println(answer);
    } catch (ApiException e) {
      // A refusal is a problem; its type ends in the slug.
      Problem problem = client.getObjectMapper()
          .readValue(e.getResponseBody(), Problem.class);
      String type = problem.getType();
      String slug = type.substring(type.lastIndexOf(':') + 1);
      System.err.println(e.getCode() + " " + slug + " " + problem.getDetail());
    }
  }
}

{
  "statement": {
    "externalStatementId": "st-4c7e6a7e3a8871a23918",
    "externalSourceId": "fund-admin-nav",
    "kind": "nav",
    "instrumentId": "FUND",
    "businessDate": "2026-10-03",
    "asOf": "2026-10-03T16:00:00Z",
    "period": null,
    "reference": null,
    "currency": "USD",
    "totalQuantity": null,
    "totalAmount": null,
    "lineCount": 0,
    "rawFormat": "application/json",
    "adapter": "canonical-json",
    "contentHash": "5dca1cb69becd45f723107f0d8e3e68a3499a2d68c6d6dcaf0ce26ceac1a8198",
    "receivedAt": "2026-10-03T13:31:06.634805Z",
    "receivedBy": "fund-admin-feed",
    "nav": {
      "official": "1.004",
      "indicative": null,
      "indicativeAsOf": null,
      "expiresAt": "2026-10-04T16:00:00Z",
      "ripcord": false
    }
  },
  "replayed": true,
  "run": null
}

{
  "statement": {
    "externalStatementId": "st-4c7e6a7e3a8871a23918",
    "externalSourceId": "fund-admin-nav",
    "kind": "nav",
    "instrumentId": "FUND",
    "businessDate": "2026-10-03",
    "asOf": "2026-10-03T16:00:00Z",
    "period": null,
    "reference": null,
    "currency": "USD",
    "totalQuantity": null,
    "totalAmount": null,
    "lineCount": 0,
    "rawFormat": "application/json",
    "adapter": "canonical-json",
    "contentHash": "5dca1cb69becd45f723107f0d8e3e68a3499a2d68c6d6dcaf0ce26ceac1a8198",
    "receivedAt": "2026-10-03T13:31:06.634805029Z",
    "receivedBy": "fund-admin-feed",
    "nav": {
      "official": "1.004",
      "indicative": null,
      "indicativeAsOf": null,
      "expiresAt": "2026-10-04T16:00:00Z",
      "ripcord": false
    }
  },
  "replayed": false,
  "run": {
    "reconciliationRunId": "recon-678-1791034266634",
    "trigger": "statement",
    "offset": 678,
    "now": "2026-10-03T13:31:06.634805029Z",
    "horizon": {
      "pinOffset": 678,
      "oldestOffset": 48,
      "latestOffset": 678,
      "note": "the projection's history begins at offset 48 (oldest_offset()); evidence below it is reported not-checkable by the check that needed it"
    },
    "checks": [
      {
        "check": "rows-vs-holdings",
        "verdict": "ok",
        "subjects": 0,
        "findings": [],
        "notCheckable": []
      }
    ],
    "qualifier": "1 finding(s) in the registry's projection at offset 678",
    "cap": "a control, not a guarantee: the observation surface is itself registry-supplied, and a reconciliation service run by the registry inherits that limitation whole",
    "durationMs": 131,
    "findingCount": 1,
    "verdict": "finding"
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}