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

# Get a contact by ID



## OpenAPI

````yaml GET /contacts/{contactId}
openapi: 3.0.0
info:
  title: Cogfy Messenger Public API
  version: 1.0.0
  description: API for interacting with the Cogfy Messenger platform
servers:
  - url: https://messenger-public-api.cogfy.com
    description: Production server
  - url: http://localhost:53981
    description: Local server
security:
  - ApiKeyAuth: []
tags: []
paths:
  /contacts/{contactId}:
    get:
      tags:
        - Contacts
      summary: Get a contact by ID
      parameters:
        - in: path
          name: contactId
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A contact
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  workspaceId:
                    type: string
                    format: uuid
                  statusId:
                    type: string
                    format: uuid
                    nullable: true
                  waId:
                    type: string
                    nullable: true
                  waProfileName:
                    type: string
                    nullable: true
                  firstName:
                    type: string
                    nullable: true
                  lastName:
                    type: string
                    nullable: true
                  email:
                    type: string
                    format: email
                    nullable: true
                  phone:
                    type: string
                    nullable: true
                  occupation:
                    type: string
                    nullable: true
                  gender:
                    type: string
                    nullable: true
                  birthDate:
                    type: string
                    format: date
                    nullable: true
                  age:
                    type: integer
                    nullable: true
                  notes:
                    type: string
                    nullable: true
                  createDate:
                    type: string
                    format: date-time
                  updateDate:
                    type: string
                    format: date-time
                  customProperties:
                    type: object
                    additionalProperties:
                      type: string
                    description: Custom properties associated with the contact
                    example:
                      Favorite Color: Blue
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key

````