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

# List contacts

> Retrieve a list of all contacts in your workspace. Results are ordered by creation date (newest first).

<Warning>
  **Deprecated:** This is a **v1** endpoint. It will continue to work, but we recommend migrating to
  the [v2 equivalent](/api-reference) for improved REST compliance (correct HTTP status codes,
  consistent response envelopes, and hyphenated URLs).
</Warning>

<Info>Replace `{your-subdomain}` with your workspace's subdomain. <br /> Learn how to find your subdomain in [Workspace subdomain](/getting-started/workspace-subdomain).</Info>


## OpenAPI

````yaml /bundled-v1/contacts.yaml GET /contacts
openapi: 3.0.3
info:
  title: NeetoCRM Contacts APIs
  version: 1.0.0
servers:
  - description: NeetoCRM APIs
    url: https://{your-subdomain}.neetocrm.com/api/external/v1
    variables:
      your-subdomain:
        default: spinkart
        description: >-
          Replace **spinkart** with your [workspace's
          subdomain](/getting-started/workspace-subdomain).
security: []
tags:
  - name: Contacts
    description: APIs to manage contacts in your workspace.
paths:
  /contacts:
    get:
      tags:
        - Contacts
      summary: List contacts
      description: >-
        Retrieve a list of all contacts in your workspace. Results are ordered
        by creation date (newest first).
      parameters:
        - $ref: '#/components/parameters/api_key_header'
        - $ref: '#/components/parameters/page_number_param'
        - $ref: '#/components/parameters/page_size_param'
      responses:
        '200':
          description: Successfully retrieved contacts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/contact_list_response'
components:
  parameters:
    api_key_header:
      in: header
      name: X-Api-Key
      description: >-
        Use the X-Api-Key header to provide your workspace API key. Refer to
        [Authentication](/getting-started/authentication) for more information.
      required: true
      schema:
        type: string
    page_number_param:
      in: query
      name: page_number
      description: >-
        Retrieve paginated results by specifying the desired page number. If
        this parameter is absent, all results will be returned.
      required: false
      schema:
        type: integer
    page_size_param:
      in: query
      name: page_size
      description: >-
        Set the number of results returned in the response. Defaulting to 30
        when omitted.
      required: false
      schema:
        type: integer
  schemas:
    contact_list_response:
      type: object
      properties:
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/contact'
          description: List of contacts.
        pagination:
          $ref: '#/components/schemas/pagination'
      example:
        contacts:
          - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
            name: Eve
            email: eve@example.com
            phone_number: ''
            created_at: '2025-03-15T10:30:00.000Z'
            updated_at: '2025-03-15T10:30:00.000Z'
            owner: null
            tags: []
            company:
              id: null
              name: null
          - id: b2c3d4e5-f6a7-8901-bcde-f12345678901
            name: Oliver
            email: oliver@example.com
            phone_number: '+1555123456'
            created_at: '2025-03-14T14:22:00.000Z'
            updated_at: '2025-03-14T14:22:00.000Z'
            owner: null
            tags: []
            company:
              id: null
              name: null
        pagination:
          total_records: 42
          total_pages: 2
          current_page_number: 1
          page_size: 30
    contact:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the contact.
        name:
          type: string
          description: Name of the contact.
        email:
          type: string
          nullable: true
          description: Email address of the contact.
        phone_number:
          type: string
          nullable: true
          description: Phone number of the contact.
        owner:
          type: string
          nullable: true
          description: Owner of the contact.
        tags:
          type: array
          items:
            type: string
          description: Tags associated with the contact.
        company:
          type: object
          nullable: true
          description: Associated company.
          properties:
            id:
              type: string
              description: Unique identifier of the company.
            name:
              type: string
              description: Name of the company.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the contact was created.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the contact was last updated.
    pagination:
      type: object
      properties:
        total_records:
          type: integer
          description: Total number of records.
        total_pages:
          type: integer
          description: Total number of pages available.
        current_page_number:
          type: integer
          description: Current page number.
        page_size:
          type: integer
          description: Number of records per page.

````