Get a payment history by ID

GET/payment-history/{account_id}

Verified staff/service with payments:read or staff with payments:operations:write authority is required. Rebuild the account's payment-and-fee sequence from retained ledger journals and fee corrections. Optional from and through (YYYY-MM-DD) bound the window. The running balance of the last event equals the ledger closing balance when ties_to_ledger is true. Customer authority is refused. Requests are strict single JSON objects bounded to 8 MiB; complete responses are bounded to 16 MiB and never silently truncated.

Path parameters

account_idstringRequired

Query parameters

fromstringOptional

throughstringOptional

Returns

200 OK

The Payment History object.

Errors

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

400401403404409412413422424429500503

Request

curl -X GET 'https://api.dev.bank.corgi.com/payment-history/{account_id}' \
  -H "Authorization: Bearer $TOKEN"

Response200

{
  "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "closing_amount": 10000,
  "corrections": [
    {
      "actor": "string",
      "application": {
        "actor": "string",
        "at": "2026-09-17T14:30:00Z",
        "correction_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm"
      },
      "content_sha256": "string",
      "correction_minor": 0,
      "created_at": "2026-09-17T14:30:00Z",
      "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "decision": {
        "actor": "string",
        "at": "2026-09-17T14:30:00Z",
        "content_sha256": "string",
        "decision": "string",
        "reason": "string"
      },
      "fee": {
        "amount_minor": 0,
        "currency_code": "USD",
        "effective_date": "2026-09-17",
        "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "source_ref": "string"
      },
      "id": "string",
      "request": {
        "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "fee_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "method": "string",
        "reason": "string",
        "target_fee_minor": 0
      }
    }
  ],
  "currency_code": "USD",
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "events": [
    {
      "amount": 10000,
      "category": "string",
      "committed_at": "2026-09-17T14:30:00Z",
      "correction_id": "string",
      "currency_code": "USD",
      "direction": "string",
      "effective_date": "2026-09-17",
      "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "kind": "string",
      "running_amount": 10000,
      "source_ref": "string"
    }
  ],
  "fees_assessed_amount": 10000,
  "fees_corrected_amount": 10000,
  "from": "2026-09-17",
  "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "opening_amount": 10000,
  "through": "2026-09-17",
  "ties_to_ledger": false
}