> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monaco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Contact

> Gets a single contact by its `contact_id`. The detail response includes scoring, source attribution, and custom fields.



## OpenAPI

````yaml https://api.monaco.com/openapi.json get /v1/contacts/{contact_id}
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/contacts/{contact_id}:
    get:
      tags:
        - Contacts
      summary: Get a Contact
      description: >-
        Gets a single contact by its `contact_id`. The detail response includes
        scoring, source attribution, and custom fields.
      operationId: get_contact
      parameters:
        - name: contact_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Contact Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicItemResponse_ContactDetailResponse_'
              example:
                data:
                  id: con_abc123
                  account_id: acc_def456
                  first_name: Jane
                  last_name: Smith
                  email: jane@acme.com
                  title: VP of Engineering
                  phone_number: +1-555-123-4567
                  linkedin_url: https://linkedin.com/in/janesmith
                  location: San Francisco, CA
                  source: linkedin
                  do_not_contact: false
                  notes: Met at SaaStr 2025
                  scoring:
                    heat_score: Hot
                  heat_score_explanation:
                    explanations:
                      - signal_type: intent
                        signal_point: Opened last 3 emails
                    firmographic: []
                  tags:
                    - Interested
                    - Decision Maker
                  created_at: '2025-06-15T10:30:00Z'
                  updated_at: '2025-06-16T10:30:00Z'
                  custom_field_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d: economic_buyer
                  custom_field_2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e: '2026-04-18'
                  custom_field_explanations:
                    custom_field_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d:
                      title: Reasoning
                      body: Held budget authority in the last two deals.
                      confidence: high
                meta:
                  timestamp: '2026-04-21T12:00:00Z'
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    PublicItemResponse_ContactDetailResponse_:
      properties:
        data:
          $ref: '#/components/schemas/ContactDetailResponse'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
      title: PublicItemResponse[ContactDetailResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    ContactDetailResponse:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the contact
          examples:
            - con_abc123
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Id
          description: ID of the associated account
          examples:
            - acc_def456
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
          description: First name of the contact
          examples:
            - Jane
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
          description: Last name of the contact
          examples:
            - Smith
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
          description: Email address of the contact
          examples:
            - jane@acme.com
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Job title of the contact
          examples:
            - VP of Engineering
        phone_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone Number
          description: Phone number of the contact
          examples:
            - +1-555-123-4567
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Url
          description: LinkedIn profile URL
          examples:
            - https://linkedin.com/in/janesmith
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
          description: Location of the contact
          examples:
            - San Francisco, CA
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
          description: Source from which the contact was added
          examples:
            - linkedin
        do_not_contact:
          type: boolean
          title: Do Not Contact
          description: Whether the contact has opted out of outreach
          default: false
        notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Notes
          description: Notes about the contact
          examples:
            - Met at SaaStr 2025
        scoring:
          anyOf:
            - $ref: >-
                #/components/schemas/api__public_api__schemas__contacts__ScoringInfo
            - type: 'null'
          description: Contact scoring information
        tags:
          items:
            type: string
          type: array
          title: Tags
          description: List of tag names associated with the contact
          examples:
            - - Interested
              - Decision Maker
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Date and time the contact was created
          examples:
            - '2025-06-15T10:30:00Z'
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Date and time the contact was last updated
          examples:
            - '2025-06-15T10:30:00Z'
        last_activity_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Activity At
          description: >-
            Date and time of the contact's most recent activity (inbound or
            outbound)
          examples:
            - '2025-06-15T10:30:00Z'
        last_activity_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Activity Type
          description: Type of the contact's most recent activity
          examples:
            - outbound_email
        last_outbound_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Outbound At
          description: >-
            Date and time of the most recent outbound interaction with the
            contact
          examples:
            - '2025-06-15T10:30:00Z'
        last_outbound_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Outbound Type
          description: Type of the most recent outbound interaction with the contact
          examples:
            - email
        last_inbound_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Inbound At
          description: >-
            Date and time of the most recent inbound interaction from the
            contact
          examples:
            - '2025-06-15T10:30:00Z'
        last_inbound_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Inbound Type
          description: Type of the most recent inbound interaction from the contact
          examples:
            - email
        heat_score_explanation:
          anyOf:
            - $ref: '#/components/schemas/ScoreExplanation'
            - type: 'null'
          description: Per-signal explanations behind the heat score tier
        custom_field_explanations:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/CustomFieldExplanation'
              type: object
            - type: 'null'
          title: Custom Field Explanations
          description: >-
            AI-generated reasoning behind custom field values, keyed by the same
            `custom_field_<uuid>` key as the value itself.
      additionalProperties: true
      type: object
      required:
        - id
        - created_at
        - updated_at
      title: ContactDetailResponse
      description: >-
        Single-resource contact response, with heat score signals and custom
        field reasoning.
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail
    api__public_api__schemas__contacts__ScoringInfo:
      properties:
        heat_score:
          anyOf:
            - type: string
            - type: 'null'
          title: Heat Score
          description: Heat score tier
          examples:
            - Hot
      type: object
      title: ScoringInfo
    ScoreExplanation:
      properties:
        explanations:
          items:
            $ref: '#/components/schemas/ScoreSignalExplanation'
          type: array
          title: Explanations
          description: Behavioral and intent signals behind the score
        firmographic:
          items:
            $ref: '#/components/schemas/ScoreSignalExplanation'
          type: array
          title: Firmographic
          description: Firmographic signals behind the score
      type: object
      title: ScoreExplanation
    CustomFieldExplanation:
      properties:
        title:
          type: string
          title: Title
          description: Explanation heading
          examples:
            - Reasoning
        body:
          type: string
          title: Body
          description: AI-generated explanation for the custom field value
        confidence:
          anyOf:
            - type: string
            - type: 'null'
          title: Confidence
          description: Confidence level of the AI-generated explanation
        citations:
          anyOf:
            - items:
                $ref: '#/components/schemas/CustomFieldCitation'
              type: array
            - type: 'null'
          title: Citations
          description: Sources backing the explanation, capped and empty-pruned
      type: object
      required:
        - title
        - body
      title: CustomFieldExplanation
    ScoreSignalExplanation:
      properties:
        signal_type:
          type: string
          title: Signal Type
          description: Type of signal contributing to the score
          examples:
            - web_visit
        signal_point:
          type: string
          title: Signal Point
          description: Human-readable explanation of the signal's contribution
          examples:
            - Visited pricing page 3 times in the last 7 days
      type: object
      required:
        - signal_type
        - signal_point
      title: ScoreSignalExplanation
    CustomFieldCitation:
      properties:
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: Source URL for the citation
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Title of the cited source
        excerpts:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Excerpts
          description: Relevant excerpts from the cited source
      type: object
      title: CustomFieldCitation

````