Skip to content

Corgi BankDocumentation

OpenAPI

The Cardholder Authority object

Independently reviewed person-bound spending authority or historical card binding.

Attributes

actorstringRequired

atstring · date-timeRequired

content_sha256stringRequired

eligibilityobjectRequired

13 child attributes

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

account_openbooleanRequired

activebooleanRequired

death_revisionintegerOptional

deceasedbooleanRequired

funding_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

holder_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

kyc_verifiedbooleanRequired

ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

ownerbooleanRequired

ownersarray of stringsRequired

ownership_revisionintegerRequired

personbooleanRequired

idstringRequired

Example chra_2tVh8nqLxq4GbDe0K1F6S9zRcWm

requestobjectRequired

8 child attributes

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

card_idstringOptional

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

evidence_refstringRequired

evidence_sha256stringRequired

expires_atstring · date-timeRequired

facility_idstringOptional

holder_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reasonstringRequired

reviewobject or nullOptional

5 child attributes

actorstringRequired

approvebooleanRequired

atstring · date-timeRequired

content_sha256stringRequired

reasonstringRequired

revocationobject or nullOptional

4 child attributes

actorstringRequired

atstring · date-timeRequired

evidence_refstringRequired

reasonstringRequired

The Cardholder Authority object

{
  "actor": "string",
  "at": "2026-09-17T14:30:00Z",
  "content_sha256": "string",
  "eligibility": {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "account_open": false,
    "active": false,
    "death_revision": 0,
    "deceased": false,
    "funding_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "holder_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "kyc_verified": false,
    "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "owner": false,
    "owners": [
      "string"
    ],
    "ownership_revision": 0,
    "person": false
  },
  "id": "chra_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "request": {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "evidence_ref": "string",
    "evidence_sha256": "string",
    "expires_at": "2026-09-17T14:30:00Z",
    "facility_id": "string",
    "holder_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "reason": "string"
  },
  "review": {
    "actor": "string",
    "approve": false,
    "at": "2026-09-17T14:30:00Z",
    "content_sha256": "string",
    "reason": "string"
  },
  "revocation": {
    "actor": "string",
    "at": "2026-09-17T14:30:00Z",
    "evidence_ref": "string",
    "reason": "string"
  }
}