Create a correspondent invoice

POST/ledger/correspondent/invoices

Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the maker. Nostro and correspondent ledger accounts are opened, posted and closed only through this module.

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

currency_codestringRequired

document_sha256stringRequired

invoice_numberstringRequired

linesarray of objectsRequired

4 child attributes

amountintegerRequired

codestringRequired

descriptionstringOptional

uetrstringOptional

nostro_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

periodstringRequired

source_refstringRequired

total_amountintegerRequired

Returns

200 OK

The Correspondent Invoice object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/ledger/correspondent/invoices' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "currency_code": "USD",
    "document_sha256": "string",
    "invoice_number": "string",
    "lines": [
      {
        "amount": 10000,
        "code": "string",
        "description": "string",
        "uetr": "string"
      }
    ],
    "nostro_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "period": "string",
    "source_ref": "string",
    "total_amount": 10000
  }'

Response200

{
  "accrued_amount": 10000,
  "accrued_not_invoiced": [
    "string"
  ],
  "billed_charge_ids": [
    "string"
  ],
  "currency_code": "USD",
  "document_sha256": "string",
  "exceptions": false,
  "id": "string",
  "invoice_number": "string",
  "lines": [
    {
      "amount": 10000,
      "code": "string",
      "description": "string",
      "uetr": "string"
    }
  ],
  "matches": [
    {
      "amount": 10000,
      "charge_id": "string",
      "code": "string",
      "description": "string",
      "expected_amount": 10000,
      "outcome": "string",
      "uetr": "string",
      "variance_amount": 10000
    }
  ],
  "nostro_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "period": "string",
  "recorded_at": "2026-09-17T14:30:00Z",
  "recorded_by": "string",
  "review": {
    "approve": false,
    "checker": "string",
    "reason": "string",
    "recorded_at": "2026-09-17T14:30:00Z"
  },
  "settlement_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "source_ref": "string",
  "statement_item_ref": "string",
  "status": "string",
  "total_amount": 10000,
  "variance_amount": 10000
}