GET
/
api
/
v1
/
contacts
/
{contact_id}

​
Get Contact Details

Retrieve detailed information about a specific contact by ID.

​
Endpoint

GET /api/v1/contacts/{contact_id}

​
Authentication

This endpoint requires an API key with the can_read_contacts permission.

​
Path Parameters

ParameterTypeRequiredDescription
contact_idintegerYesThe ID of the contact to retrieve

​
Response

{
  "id": 123,
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "email": "[email protected]",
  "company": "Acme Corp",
  "website": "https://acme.example.com",
  "stage": "qualified_lead",
  "stage_display": "Qualified Lead",
  "status": "contacted",
  "status_display": "Contacted",
  "address": {
    "street": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "country": "US"
  },
  "timezone": "America/Los_Angeles",
  "created_date": "2025-03-15T10:30:00Z",
  "last_call_date": "2025-04-22T14:15:30Z",
  "phone_numbers": [
    {
      "id": 456,
      "phone_number": "+15551234567",
      "phone_type": "mobile",
      "primary": true,
      "do_not_call": false,
      "dnc_date": null,
      "dnc_reason": null
    },
    {
      "id": 457,
      "phone_number": "+15552345678",
      "phone_type": "work",
      "primary": false,
      "do_not_call": false,
      "dnc_date": null,
      "dnc_reason": null
    }
  ],
  "tags": ["VIP", "Interested", "Follow-up"],
  "recent_notes": [
    {
      "id": 789,
      "content": "Customer expressed interest in the premium package. Will follow up next week.",
      "created_at": "2025-04-22T14:45:30Z",
      "note_type": "call_note",
      "call_result": "interested"
    },
    {
      "id": 790,
      "content": "Sent follow-up email with pricing details.",
      "created_at": "2025-04-22T15:10:00Z",
      "note_type": "activity",
      "call_result": null
    }
  ],
  "custom_context": {
    "lead_source": "Website",
    "budget": "$5,000-$10,000",
    "decision_maker": true
  },
  "industry_context": {
    "company_size": "50-250",
    "industry_vertical": "Technology"
  },
  "team": {
    "id": 101,
    "name": "Sales Team"
  },
  "owner": {
    "id": 202,
    "username": "sales_rep",
    "email": "[email protected]"
  }
}

​
Error Codes

Status CodeError CodeDescription
401authentication_requiredNo API key was provided
401invalid_keyThe API key is invalid or inactive
403permission_deniedThe API key doesn’t have the required permission
404not_foundContact not found or you do not have access
500server_errorAn unexpected server error occurred

​
Example Request

curl -X GET 'https://api.klen.ai/api/v1/contacts/123' \
  -H 'Authorization: Bearer klen_abcdef123456789'

​
Example Response

The response includes comprehensive information about the contact, including personal details, communication history, custom context data, and ownership information as shown in the response schema above.

​
Response Properties

PropertyTypeDescription
idintegerThe database ID of the contact
first_namestringFirst name of the contact
last_namestringLast name of the contact
full_namestringCombined first and last name
emailstringEmail address of the contact
companystringCompany or organization name
websitestringCompany or personal website URL
stagestringCurrent stage in the sales/contact pipeline
stage_displaystringHuman-readable stage name
statusstringCurrent status of the contact
status_displaystringHuman-readable status name
addressobjectPhysical address information
timezonestringContact’s timezone (IANA format)
created_datestringISO 8601 date when the contact was created
last_call_datestringISO 8601 date of the most recent call
phone_numbersarrayList of phone numbers associated with the contact
tagsarrayArray of tag names associated with the contact
recent_notesarrayList of recent notes about the contact
custom_contextobjectCustom fields and data specific to this contact
industry_contextobjectIndustry-specific information
teamobjectTeam information if the contact belongs to a team
ownerobjectUser information for the contact owner

​
Access Control

This endpoint will only return contacts that the authenticated user has access to, either through direct ownership or team access permissions.