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

# Get contact detail

> **Get a single contact with its cross-campaign history**

Returns the contact's profile, signal, engagement rollups and tags, plus one
entry per campaign membership with its per-campaign status and timing.



## OpenAPI

````yaml /public_openapi.json get /api/public/v1/contacts/{contact_id}
openapi: 3.0.3
info:
  title: ColdSend Public API
  description: >-
    Programmatic access to ColdSend for managing cold email campaigns and sender
    accounts.
  version: 1.0.0
  contact:
    name: ColdSend Support
    email: support@coldsend.pro
    url: https://coldsend.pro
servers:
  - url: https://api.coldsend.pro
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/public/v1/contacts/{contact_id}:
    get:
      tags:
        - Contacts
      summary: Get contact detail
      description: >-
        **Get a single contact with its cross-campaign history**


        Returns the contact's profile, signal, engagement rollups and tags, plus
        one

        entry per campaign membership with its per-campaign status and timing.
      operationId: get_contact_api_public_v1_contacts__contact_id__get
      parameters:
        - name: contact_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Contact Id
      responses:
        '200':
          description: Contact retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactDetailApiResponse'
        '403':
          description: Insufficient permissions - requires 'contacts:read' scope
        '404':
          description: Contact not found in this team
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ContactDetailApiResponse:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        message:
          type: string
          title: Message
          default: Contact retrieved
        contact:
          $ref: '#/components/schemas/ContactDetailResponse'
      type: object
      required:
        - contact
      title: ContactDetailApiResponse
      description: Response for a single contact with its campaign memberships.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ContactDetailResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        team_id:
          type: string
          format: uuid
          title: Team Id
        email:
          type: string
          title: Email
        first_name:
          type: string
          nullable: true
          title: First Name
        last_name:
          type: string
          nullable: true
          title: Last Name
        company:
          type: string
          nullable: true
          title: Company
        custom_fields:
          additionalProperties: true
          type: object
          nullable: true
          title: Custom Fields
        signal:
          $ref: '#/components/schemas/ContactSignal'
        signal_override:
          $ref: '#/components/schemas/ContactSignal'
          nullable: true
        signal_computed_at:
          type: string
          format: date-time
          nullable: true
          title: Signal Computed At
        source_type:
          type: string
          nullable: true
          title: Source Type
        source_name:
          type: string
          nullable: true
          title: Source Name
        first_batch_id:
          type: string
          format: uuid
          nullable: true
          title: First Batch Id
        last_touch_at:
          type: string
          format: date-time
          nullable: true
          title: Last Touch At
        last_reply_at:
          type: string
          format: date-time
          nullable: true
          title: Last Reply At
        last_open_at:
          type: string
          format: date-time
          nullable: true
          title: Last Open At
        campaign_count:
          type: integer
          title: Campaign Count
          default: 0
        is_unsubscribed:
          type: boolean
          title: Is Unsubscribed
          default: false
        is_bounced:
          type: boolean
          title: Is Bounced
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        tags:
          items:
            $ref: '#/components/schemas/ContactTagResponse'
          type: array
          title: Tags
        campaign_names:
          items:
            type: string
          type: array
          title: Campaign Names
        campaigns:
          items:
            $ref: '#/components/schemas/ContactCampaignResponse'
          type: array
          title: Campaigns
        is_suppressed:
          type: boolean
          title: Is Suppressed
          default: false
        suppression_reason:
          type: string
          nullable: true
          title: Suppression Reason
      type: object
      required:
        - id
        - team_id
        - email
        - signal
        - created_at
        - updated_at
      title: ContactDetailResponse
      description: A contact plus its complete cross-campaign history.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ContactSignal:
      type: string
      enum:
        - NEVER_CONTACTED
        - CONTACTED
        - ENGAGED
        - HOT_LEAD
        - BOUNCED
        - UNSUBSCRIBED
      title: ContactSignal
      description: |-
        Engagement signal for a directory contact.

        Materialised onto `contacts.signal` by the contact rollup job so the
        directory can filter and sort on it without touching `leads`. Derived
        from the contact's campaign memberships in strict precedence order --
        the first match wins:

            UNSUBSCRIBED    : suppressed for this team, i.e. a row exists in
                              `unsubscribes` for (team_id, email) with
                              unsubscribed_at IS NOT NULL. Suppression is
                              email-keyed, so this is independent of any
                              particular lead row.
            BOUNCED         : a membership bounced and the contact has never
                              otherwise engaged.
            HOT_LEAD        : a thread carries a positive INTENT tag
                              (Demo Booked / Interested).
            ENGAGED         : has replied or opened, or a thread carries the
                              Question INTENT tag.
            CONTACTED       : has been sent to, but no engagement recorded.
            NEVER_CONTACTED : no membership has been sent yet.

        A non-NULL `contacts.signal_override` always wins over the derived
        value, so a manually pinned signal is never clobbered by the job.

        Mirrors the `contactsignal` Postgres enum created in migration
        `20260826_0001_add_contact_directory.py`. Keep in sync.
    ContactTagResponse:
      properties:
        tag_id:
          type: string
          format: uuid
          title: Tag Id
        name:
          type: string
          title: Name
        color:
          type: string
          nullable: true
          title: Color
        category_group:
          type: string
          nullable: true
          title: Category Group
        is_system:
          type: boolean
          title: Is System
          default: false
        applied_by_id:
          type: string
          format: uuid
          nullable: true
          title: Applied By Id
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - tag_id
        - name
        - created_at
      title: ContactTagResponse
      description: A team tag applied to a contact.
    ContactCampaignResponse:
      properties:
        lead_id:
          type: string
          format: uuid
          title: Lead Id
        campaign_id:
          type: string
          format: uuid
          nullable: true
          title: Campaign Id
        campaign_name:
          type: string
          nullable: true
          title: Campaign Name
        status:
          type: string
          nullable: true
          title: Status
        sequence_step:
          type: integer
          title: Sequence Step
          default: 0
        is_external:
          type: boolean
          title: Is External
          default: false
        last_contacted_at:
          type: string
          format: date-time
          nullable: true
          title: Last Contacted At
        opened_at:
          type: string
          format: date-time
          nullable: true
          title: Opened At
        replied_at:
          type: string
          format: date-time
          nullable: true
          title: Replied At
        unsubscribed:
          type: boolean
          title: Unsubscribed
          default: false
        created_at:
          type: string
          format: date-time
          nullable: true
          title: Created At
      type: object
      required:
        - lead_id
      title: ContactCampaignResponse
      description: |-
        One campaign membership of a contact -- i.e. one `leads` row.

        `campaign_id` is nullable: external leads (created from an inbound cold
        email) carry no campaign but are still memberships of the contact.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with format cs_live_xxx

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.