Skip to content

Corgi BankDocumentation

OpenAPI

Record a version of a business's natural-person owners and control person; customers:write service credential, idempotency key and expected_version required; reopens KYC review

POST/customers/{id}/business-parties

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

evidence_refstringRequired

expected_versionintegerRequired

partiesarray of objectsRequired

3 child attributes

control_personbooleanRequired

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

ownership_bpsintegerRequired

reasonstringRequired

Returns

201 Created

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

evidence_refstringRequired

partiesarray of objectsRequired

3 child attributes

control_personbooleanRequired

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

ownership_bpsintegerRequired

reasonstringRequired

recorded_atstring · date-timeRequired

recorded_bystringRequired

versionintegerRequired

Errors

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

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/customers/{id}/business-parties' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "evidence_ref": "string",
    "expected_version": 0,
    "parties": [
      {
        "control_person": false,
        "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "ownership_bps": 0
      }
    ],
    "reason": "string"
  }'

Response201

{
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "evidence_ref": "string",
  "parties": [
    {
      "control_person": false,
      "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "ownership_bps": 0
    }
  ],
  "reason": "string",
  "recorded_at": "2026-09-17T14:30:00Z",
  "recorded_by": "string",
  "version": 0
}