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

# List saved segments

> Every contact list the team has saved, newest first. Optionally narrowed to STATIC or DYNAMIC.



## OpenAPI

````yaml /public_openapi.json get /api/public/v1/contacts/lists
openapi: 3.0.3
info:
  title: ColdSend Public API
  description: >-
    Programmatic access to ColdSend for managing cold email campaigns and sender
    accounts.
  version: 1.0.0
  contact:
    name: ColdSend Support
    email: support@coldsend.pro
    url: https://coldsend.pro
servers:
  - url: https://api.coldsend.pro
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/public/v1/contacts/lists:
    get:
      tags:
        - Contacts
      summary: List saved segments
      description: >-
        Every contact list the team has saved, newest first. Optionally narrowed
        to STATIC or DYNAMIC.
      operationId: list_contact_lists_api_public_v1_contacts_lists_get
      parameters:
        - name: list_type
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/ContactListType'
            nullable: true
            title: List Type
            description: Restrict to one list type
          description: Restrict to one list type
      responses:
        '200':
          description: Lists retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactListsApiResponse'
        '403':
          description: Insufficient permissions - requires 'contacts:read' scope
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ContactListType:
      type: string
      enum:
        - DYNAMIC
        - STATIC
      title: ContactListType
      description: |-
        Whether a contact list computes its members or stores them.

        DYNAMIC lists evaluate `contact_lists.filter_definition` at query time
        and therefore pick up newly created contacts automatically. STATIC
        lists materialise membership rows in `contact_list_members`.
    ContactListsApiResponse:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        message:
          type: string
          title: Message
        total:
          type: integer
          title: Total
        lists:
          items:
            $ref: '#/components/schemas/ContactListResponse'
          type: array
          title: Lists
      type: object
      required:
        - message
        - total
        - lists
      title: ContactListsApiResponse
      description: Response for the team's saved segments.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ContactListResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        team_id:
          type: string
          format: uuid
          title: Team Id
        name:
          type: string
          title: Name
        description:
          type: string
          nullable: true
          title: Description
        list_type:
          type: string
          title: List Type
        filter_definition:
          additionalProperties: true
          type: object
          nullable: true
          title: Filter Definition
        created_by_user_id:
          type: string
          format: uuid
          nullable: true
          title: Created By User Id
        cached_count:
          type: integer
          nullable: true
          title: Cached Count
        count_refreshed_at:
          type: string
          format: date-time
          nullable: true
          title: Count Refreshed At
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - id
        - team_id
        - name
        - list_type
        - created_at
        - updated_at
      title: ContactListResponse
      description: A saved segment.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with format cs_live_xxx

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.