# List All

GET /api/v2/projects/{projectId}/crm/contact-lists

Lists a project's contact lists with a total `count`. Narrow to one kind with `type`, or pass `contactId` to find the lists a particular contact belongs to.

## Request

- projectId: string, path, required — ID of the project to list contact lists from.
- contactId: string, query — Only return lists that this contact is a member of.
- orderBy: name | createdAt | updatedAt, query — Field to sort by.
- orderDirection: asc | desc, query — Sort direction. Ignored unless `orderBy` is set.
- skip: number, query — Number of lists to skip before collecting results.
- take: number, query — Maximum number of lists to return.
- type: static | dynamic, query — Only return lists of this kind: `static` for a fixed set of members you manage explicitly, `dynamic` for a saved filter whose membership is recomputed on read.

## Response

- 200: Successful response
  - count: number, required
  - data: object[], required
    - contactsFilterGroups: object[], required
    - createdAt: string, required
    - id: string, required
    - name: string, required
    - projectId: string, required
    - type: static | dynamic, required, default static
    - updatedAt: string, required
    - description: string
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 404: Not found
- 500: Internal server error