Get contact

One contact card: details, categories, requirements, linked properties and upcoming events.

GET https://cotlet.dev/api/v1/vaultre/contacts/{contact_id}

read

Returns the contact as the card and its snapshot show it: type, all numbers and emails, address, sources of enquiry, categories, buy or rent requirements, linked properties and upcoming events and tasks. What you get back depends on the access settings of your Vault user, so a contact you cannot view fails with APP_PERMISSION_DENIED.

Parameters

Parameters: get_contact
NameTypeDescription
contact_id string required string Contact ID from search_contacts.

Request

cURL
curl https://cotlet.dev/api/v1/vaultre/contacts/contact_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("vaultre", "get_contact", {"contact_id":"contact_8c41d2"})
Node.js
const result = await cotlet.call('vaultre', 'get_contact', {"contact_id":"contact_8c41d2"});
CLI
cotlet call vaultre get_contact --data '{"contact_id":"contact_8c41d2"}'

Example response

JSON

{
  "contact_id": "51377",
  "type": "person",
  "name": "Priya Nair",
  "emails": [
    "priya.nair@example.com"
  ],
  "mobiles": [
    "0400 000 123"
  ],
  "address": "12 Station Road, Marrickville NSW 2204",
  "sources_of_enquiry": [
    "realestate.com.au"
  ],
  "categories": [
    "Buyer"
  ],
  "requirements": [
    {
      "kind": "buy",
      "description": "3 bedroom house, Marrickville"
    }
  ],
  "properties": [
    {
      "property_id": "22810",
      "address": "14 Wattle Street, Marrickville NSW 2204",
      "role": "enquirer"
    }
  ],
  "upcoming_events": [
    {
      "type": "scheduled_viewing",
      "starts_at": "2026-10-24T10:30:00+11:00"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.