Decide an international entry held on the transit account: approve, block or return (optional Idempotency-Key replays the recorded decision)

POST/ach-receipts/{id}/review

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

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

decisionstringRequired

Approve, block or return

operatorstringRequired

return_codestringOptional

Returns

200 OK

The ACH Receipt 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/ach-receipts/{id}/review' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "string",
    "operator": "string"
  }'

Response200

{
  "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "account_number": "string",
  "amount": 10000,
  "company_id": "string",
  "effective_date": "2026-09-17",
  "file_id": "achf_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "hold_reason": "string",
  "iat": {
    "correspondents": [
      {
        "branch_country": "string",
        "id": "string",
        "id_qualifier": "string",
        "name": "string"
      }
    ],
    "destination_country": "string",
    "destination_currency": "string",
    "foreign_amount": 10000,
    "foreign_exchange_indicator": "string",
    "foreign_exchange_reference": "string",
    "foreign_trace": "string",
    "ofac_indicator": "string",
    "originating_currency": "string",
    "originating_dfi": {
      "branch_country": "string",
      "id": "string",
      "id_qualifier": "string",
      "name": "string"
    },
    "originator": {
      "city": "string",
      "country": "string",
      "id": "string",
      "name": "string",
      "postal_code": "string",
      "region": "string",
      "street": "string"
    },
    "receiver": {
      "city": "string",
      "country": "string",
      "id": "string",
      "name": "string",
      "postal_code": "string",
      "region": "string",
      "street": "string"
    },
    "receiving_dfi": {
      "branch_country": "string",
      "id": "string",
      "id_qualifier": "string",
      "name": "string"
    },
    "remittance": [
      "string"
    ],
    "secondary_ofac_indicator": "string",
    "transaction_type_code": "string"
  },
  "id": "achr_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "individual_id": "string",
  "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "name": "string",
  "odfi": "string",
  "originator_name": "string",
  "outcome": "string",
  "return_code": "string",
  "return_reason": "string",
  "reversal_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "reviewed_at": "2026-09-17T14:30:00Z",
  "reviewed_by": "string",
  "screening_ids": [
    "string"
  ],
  "sec_code": "string",
  "trace_number": "string",
  "transaction_code": "string"
}