Create Child Card

POST/cards/childOpen in the API playground →

Info

Child cards allow subscribers to delegate limited spending access to dependents or employees.

Request

Authorizationstringheaderrequired

Bearer olive_live_xxx or Bearer eyJ... (JWT)

Body Parameters

parent_subscriber_idstringbodyrequired

Parent subscriber UUID

card_serialstringbodyrequired

Card serial to assign as child (e.g., OLIV0002)

parent_pinstringbodyrequired

Parent's 4-digit PIN for authorization

child_pinstringbodyrequired

New 4-digit PIN for the child card

daily_limitintegerbodyrequired

Daily spending limit in cents (e.g., 5000000 = 50,000 SLE)

child_first_namestringbody

Child's first name

child_last_namestringbody

Child's last name

child_phone_numberstringbody

Child's phone number for notifications

effective_datestringbody

When card becomes active (YYYY-MM-DD)

allocated_amountintegerbody

Initial allocated amount in cents

---

Response

successboolean

Whether creation succeeded

messagestring

Result message

cardobject

Child card details

---

Examples

Request

cURL

curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/child" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_subscriber_id": "sub_abc123",
    "card_serial": "OLIV0002",
    "parent_pin": "1234",
    "child_pin": "5678",
    "daily_limit": 5000000,
    "child_first_name": "Jane",
    "child_last_name": "Doe",
    "child_phone_number": "+23276123456"
  }'

Response

200 Success

{
  "success": true,
  "message": "Child card created successfully",
  "card": {
    "serial": "OLIV0002",
    "type": "CHILD",
    "status": "ACTIVE",
    "parent_serial": "OLIV0001",
    "parent_subscriber_id": "sub_abc123",
    "daily_limit": 5000000,
    "daily_limit_formatted": "50,000.00 SLE",
    "child_name": "Jane Doe",
    "linked_at": "2025-01-15T10:30:00Z"
  }
}

400 Limit Exceeded

{
  "error": "Maximum child cards reached",
  "code": "MAX_CHILD_CARDS",
  "max_allowed": 4
}

---

Child Card Rules

Daily Limits

• Resets at midnight local time
• Cannot exceed parent's balance
• Can be adjusted by parent

Restrictions

• Cannot create more child cards
• Cannot access parent's PIN
• Limited to assigned limit

---

Max Child Cards

The number of child cards a subscriber can create is limited:

Subscriber Type	Max Child Cards
Standard	4
VIP	10
Corporate	Unlimited

---

Errors

Status	Code	Description
400	INVALID_PARENT_PIN	Parent PIN incorrect
400	MAX_CHILD_CARDS	Subscriber limit reached
400	CARD_ALREADY_LINKED	Card already in use
401	UNAUTHORIZED	Invalid API key
404	SUBSCRIBER_NOT_FOUND	Parent subscriber not found
404	CARD_NOT_FOUND	Card serial not found
500	INTERNAL_ERROR	Server error