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

# Get Snoozed Contacts

> Returns all snoozed contacts for the team with pagination and filtering

Returns all snoozed contacts for the team with pagination and filtering support. Snoozed contacts are temporarily suppressed from call lists until their snooze period expires.

### Query Parameters

* **page** (*optional*, number): Page number for pagination. Default: 1
* **limit** (*optional*, number): Number of items per page. Min: 1, Max: 100
* **sort** (*optional*, string): Sort field(s). Prefix with "-" for descending order. Default: `-createdAt`
* **linkedin\_username** (*optional*, string): Filter by LinkedIn username
* **external\_contact\_id** (*optional*, string): Filter by external contact ID (e.g., CRM ID)
* **email** (*optional*, string): Filter by email address
* **phone\_number** (*optional*, string): Filter by phone number

### Response

Returns a paginated array of snoozed contacts with the following fields:

* `_id` - Unique identifier
* `team` - Team ID
* `user` - User who snoozed the contact
* `contact_list` - Associated contact list ID
* `linkedin_username` - LinkedIn username
* `external_contact_id` - External CRM contact ID
* `email` - Email address
* `phone_number` - Phone number
* `snooze_until` - Date when snooze expires
* `createdAt` - Creation timestamp
* `updatedAt` - Last update timestamp


## OpenAPI

````yaml GET /v1/snoozed-contacts
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/snoozed-contacts:
    get:
      tags:
        - Snoozed Contacts
      description: Returns all snoozed contacts for the team with pagination and filtering
      operationId: get-snoozed-contacts
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: Items per page
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: Sort field(s). Prefix with - for descending
        - name: linkedin_username
          in: query
          required: false
          schema:
            type: string
          description: Filter by LinkedIn username
        - name: external_contact_id
          in: query
          required: false
          schema:
            type: string
          description: Filter by external contact ID
        - name: email
          in: query
          required: false
          schema:
            type: string
          description: Filter by email
        - name: phone_number
          in: query
          required: false
          schema:
            type: string
          description: Filter by phone number
      responses:
        '200':
          description: Snoozed contacts retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnoozedContactsResponse'
components:
  schemas:
    SnoozedContactsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/SnoozedContactDTO'
        total:
          type: integer
        page:
          type: integer
        next:
          type: integer
          nullable: true
    SnoozedContactDTO:
      type: object
      properties:
        _id:
          type: string
          description: Unique identifier
        team:
          type: string
          description: Team ID
        user:
          $ref: '#/components/schemas/UserDTO'
        contact_list:
          type: string
          description: Contact list ID
        linkedin_username:
          type: string
          description: LinkedIn username
        external_contact_id:
          type: string
          description: External CRM contact ID
        email:
          type: string
          description: Email address
        phone_number:
          type: string
          description: Phone number
        snooze_until:
          type: string
          format: date-time
          description: Snooze expiration date
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - _id
        - team
        - phone_number
        - snooze_until
    UserDTO:
      type: object
      properties:
        _id:
          type: string
        email:
          type: string
        first_name:
          type: string
        last_name:
          type: string
      required:
        - _id
        - email
        - first_name
        - last_name
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````