Skip to main content
GET
/
v1
/
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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
}