> ## 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 page



## OpenAPI

````yaml GET /contacts/
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/:
    get:
      tags:
        - Contacts
      summary: Get all contacts
      parameters:
        - in: query
          name: cursor
          schema:
            type: string
          description: Cursor for pagination
        - in: query
          name: waId
          schema:
            type: string
          description: Query to filter contacts by waId
      responses:
        '200':
          description: A list of contacts
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      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
                  cursors:
                    type: object
                    properties:
                      next:
                        type: string
                        nullable: true
                        description: Cursor for the next page
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key

````