Create a dispute

POST/disputes

Record a consumer deposit EFT error notice and captured deadlines

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

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

error_kindstringRequired

evidence_refstringRequired

fees_amountintegerRequired

first_deposit_datestring · dateOptional

A business date, YYYY-MM-DD

interest_amountintegerRequired

notice_methodstringRequired

original_journal_keystringOptional

outside_statebooleanRequired

point_of_salebooleanRequired

principal_amountintegerRequired

reasonstringRequired

received_atstring · date-timeRequired

statement_sent_datestring · dateOptional

A business date, YYYY-MM-DD

transaction_datestring · dateRequired

A business date, YYYY-MM-DD

transaction_refstringRequired

Returns

201 Created

The Dispute 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/disputes' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "error_kind": "string",
    "evidence_ref": "string",
    "fees_amount": 10000,
    "interest_amount": 10000,
    "notice_method": "string",
    "outside_state": false,
    "point_of_sale": false,
    "principal_amount": 10000,
    "reason": "string",
    "received_at": "2026-09-17T14:30:00Z",
    "transaction_date": "2026-09-17",
    "transaction_ref": "string"
  }'

Response201

{
  "created_at": "2026-09-17T14:30:00Z",
  "created_by": "string",
  "deadlines": {
    "extended": false,
    "initial_due": "2026-09-17",
    "investigation_due": "2026-09-17",
    "new_account": false
  },
  "id": "string",
  "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "policy": {
    "business_days": [
      0
    ],
    "closed_dates": [
      "2026-09-17"
    ],
    "expense_gl_code": "string",
    "id": "string",
    "legal_entity": "string",
    "max_claim_amount": 10000,
    "product_codes": [
      "string"
    ],
    "suspense_gl_code": "string",
    "timezone": "string",
    "valid_from": "2026-09-17",
    "valid_through": "2026-09-17"
  },
  "product_code": "string",
  "request": {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "error_kind": "string",
    "evidence_ref": "string",
    "fees_amount": 10000,
    "first_deposit_date": "2026-09-17",
    "interest_amount": 10000,
    "notice_method": "string",
    "original_journal_key": "string",
    "outside_state": false,
    "point_of_sale": false,
    "principal_amount": 10000,
    "reason": "string",
    "received_at": "2026-09-17T14:30:00Z",
    "statement_sent_date": "2026-09-17",
    "transaction_date": "2026-09-17",
    "transaction_ref": "string"
  },
  "state": {
    "corrected_at": "2026-09-17T14:30:00Z",
    "determined_at": "2026-09-17T14:30:00Z",
    "final_amounts": {
      "fees_amount": 10000,
      "interest_amount": 10000,
      "principal_amount": 10000
    },
    "outcome": "string",
    "pending_action_id": "string",
    "provisional_amount": 10000,
    "provisional_at": "2026-09-17T14:30:00Z",
    "provisional_notice_at": "2026-09-17T14:30:00Z",
    "recovered_amount": 10000,
    "recovery_amount": 10000,
    "recovery_date": "2026-09-17",
    "recovery_notice_at": "2026-09-17T14:30:00Z",
    "results_notice_at": "2026-09-17T14:30:00Z",
    "status": "string",
    "written_off_amount": 10000
  }
}