Contacts

Get a Contact

Changed on Nov 3, 2026

Gets a single contact by its contact_id. The detail response includes scoring, source attribution, and custom fields. Pass include_reasoning=true to get each custom field as a {value, reasoning, confidence, citations} object.

get/v1/contacts/{contact_id}

Request

Base URL
https://api.monaco.com
URL
https://api.monaco.com/v1/contacts/{contact_id}
Auth
none declared

Path parameters

contact_idstring uuid required

Query parameters

include_reasoningboolean

When true, each custom_field_<uuid> key is returned as an object with inline AI reasoning: {value, reasoning, confidence, citations}.

Response

Successful Response

Example response

{
  "data": {
    "id": "con_abc123",
    "account_id": "acc_def456",
    "account_name": "Acme Corp",
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.com",
    "title": "VP of Engineering",
    "phone_number": "+1-415-555-0132",
    "linkedin_url": "https://linkedin.com/in/janesmith",
    "location": "San Francisco, CA",
    "source": "linkedin",
    "notes": "Met at SaaStr 2025",
    "scoring": {
      "heat_score": "Hot"
    },
    "tags": [
      "Interested",
      "Decision Maker"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "updated_at": "2025-06-15T10:30:00Z",
    "last_activity_at": "2025-06-15T10:30:00Z",
    "last_activity_type": "outbound_email",
    "last_outbound_at": "2025-06-15T10:30:00Z",
    "last_outbound_type": "email",
    "last_inbound_at": "2025-06-15T10:30:00Z",
    "last_inbound_type": "email",
    "heat_score_explanation": {
      "explanations": [
        {
          "signal_type": "web_visit",
          "signal_point": "Visited pricing page 3 times in the last 7 days"
        }
      ],
      "firmographic": [
        {
          "signal_type": "web_visit",
          "signal_point": "Visited pricing page 3 times in the last 7 days"
        }
      ]
    }
  }
}

Changes

Nov 3, 2026fc720ada2a81 Revision changes
- info
  added the new optional query request parameter include_reasoning
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status

Operation history