Holders

A Holder (card owner) is the person associated with one or more cards. Every card must have an assigned holder.

---

Key Points

• Create a holder once, reuse their cardOwnerId when issuing multiple cards
• email must be unique within your organization
• phone must be unique within your organization (if provided)
• You define cardOwnerId yourself — use your internal user ID for easy mapping

---

Holder Object

{
  "cardOwnerId": "owner-12345",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1-202-555-0147",
  "address": {
    "postalCode": "10001",
    "city": "New York",
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B"
  }
}

---

In This Section

• Create Holder — register a new card holder
• List & Get Holders — view holders and their details
• Update Holder — update holder information