Get Cardholder

GET

cards

cardholder

curl https://api.usenaive.ai/v1/cards/cardholder \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "cardholder": {
    "id": "ich_1abc123",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@acme.com",
    "phone": "+14155551234",
    "billingLine1": "123 Main St",
    "billingCity": "San Francisco",
    "billingState": "CA",
    "billingPostalCode": "94105",
    "billingCountry": "US",
    "type": "individual",
    "status": "active",
    "created_at": "2026-01-15T10:00:00Z"
  }
}

Retrieves the cardholder profile associated with your company. Returns null if no cardholder has been created yet.

curl https://api.usenaive.ai/v1/cards/cardholder \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "cardholder": {
    "id": "ich_1abc123",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@acme.com",
    "phone": "+14155551234",
    "billingLine1": "123 Main St",
    "billingCity": "San Francisco",
    "billingState": "CA",
    "billingPostalCode": "94105",
    "billingCountry": "US",
    "type": "individual",
    "status": "active",
    "created_at": "2026-01-15T10:00:00Z"
  }
}

If no cardholder exists yet, the response will be:

{
  "cardholder": null
}

curl https://api.usenaive.ai/v1/cards/cardholder \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "cardholder": {
    "id": "ich_1abc123",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@acme.com",
    "phone": "+14155551234",
    "billingLine1": "123 Main St",
    "billingCity": "San Francisco",
    "billingState": "CA",
    "billingPostalCode": "94105",
    "billingCountry": "US",
    "type": "individual",
    "status": "active",
    "created_at": "2026-01-15T10:00:00Z"
  }
}