> ## 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 All Lists

> Returns all CSV contact lists for the team with filtering, sorting, and pagination.

Returns all CSV contact lists for the team. This is the primary endpoint for listing your contact lists. Returns metadata only — use [Get List by ID](/api-reference/endpoint/get-contact-list-by-id) to see the contacts inside a list.

### Query Parameters

| Parameter       | Type   | Description                                                                                          |
| --------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| `search`        | string | Search lists by name (case-insensitive)                                                              |
| `filters[user]` | string | Filter by user ID                                                                                    |
| `sort`          | string | Sort by field. Prefix with `-` for descending. Default: `-createdAt`. Examples: `name`, `-updatedAt` |
| `page`          | number | Page number. Default: 1                                                                              |
| `limit`         | number | Items per page. Default: 10                                                                          |

### Response

Returns a paginated array of contact lists:

| Field            | Type   | Description                           |
| ---------------- | ------ | ------------------------------------- |
| `_id`            | string | Unique identifier of the contact list |
| `name`           | string | Name of the list                      |
| `user`           | string | ID of the user who owns the list      |
| `total_contacts` | number | Number of contacts in the list        |
| `createdAt`      | string | Date the list was created             |
| `updatedAt`      | string | Date the list was last updated        |

### Example Requests

```bash theme={null}
# Get all lists
GET /v1/contact-lists/csv

# Search by name
GET /v1/contact-lists/csv?search=outbound

# Filter by user
GET /v1/contact-lists/csv?filters[user]=680edc0d1504192884a148e0

# Sort by name ascending
GET /v1/contact-lists/csv?sort=name

# Combine filters
GET /v1/contact-lists/csv?search=q2&filters[user]=680edc0d1504192884a148e0&sort=-createdAt&page=1&limit=20
```


## OpenAPI

````yaml GET /v1/contact-lists/csv
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/contact-lists/csv:
    get:
      tags:
        - Contact Lists
      summary: Get all CSV contact lists
      description: >-
        Returns all CSV contact lists for the team with filtering, sorting, and
        pagination.
      operationId: get-contact-lists-csv
      parameters:
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: Search lists by name (case-insensitive)
        - name: filters[user]
          in: query
          required: false
          schema:
            type: string
          description: Filter by user ID
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: 'Sort field. Prefix with - for descending. Default: -createdAt'
        - 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
            default: 10
          description: Items per page
      responses:
        '200':
          description: CSV contact lists retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CSVListsResponse'
components:
  schemas:
    CSVListsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CSVListSummary'
        pagination:
          type: object
          properties:
            total:
              type: integer
            page:
              type: integer
            next:
              type: integer
              nullable: true
    CSVListSummary:
      type: object
      properties:
        _id:
          type: string
        name:
          type: string
        user:
          type: string
        total_contacts:
          type: integer
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````