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

# List Destinations



## OpenAPI

````yaml GET /api/v1/destinations/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/destinations/:
    get:
      tags:
        - v1
      operationId: v1_destinations_list
      parameters:
        - in: query
          name: archived
          schema:
            type: boolean
        - in: query
          name: connector_slug
          schema:
            type: string
        - in: query
          name: created_at__gt
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__gte
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__lt
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__lte
          schema:
            type: string
            format: date-time
        - in: query
          name: created_by
          schema:
            type: integer
        - in: query
          name: is_ml_ai_connector
          schema:
            type: boolean
        - in: query
          name: last_run_status
          schema:
            type: array
            items:
              type: string
              enum:
                - canceled
                - cancelling
                - failed
                - pending_events
                - queued
                - running
                - success
          description: |-
            Multiple values may be separated by commas.

            * `pending_events` - PENDING_EVENTS
            * `queued` - QUEUED
            * `running` - RUNNING
            * `success` - SUCCESS
            * `failed` - FAILED
            * `cancelling` - CANCELLING
            * `canceled` - CANCELED
          explode: false
          style: form
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: search
          required: false
          in: query
          description: A search term.
          schema:
            type: string
        - in: query
          name: slug
          schema:
            type: string
        - in: query
          name: sort
          schema:
            type: array
            items:
              type: string
              enum:
                - '-connector_slug'
                - '-created_at'
                - '-created_by'
                - '-description'
                - '-slug'
                - '-updated_at'
                - connector_slug
                - created_at
                - created_by
                - description
                - slug
                - updated_at
          description: |-
            Ordering

            * `slug` - Slug
            * `-slug` - Slug (descending)
            * `connector_slug` - Connector slug
            * `-connector_slug` - Connector slug (descending)
            * `description` - Description
            * `-description` - Description (descending)
            * `created_by` - Created by
            * `-created_by` - Created by (descending)
            * `created_at` - Created at
            * `-created_at` - Created at (descending)
            * `updated_at` - Updated at
            * `-updated_at` - Updated at (descending)
          explode: false
          style: form
        - in: query
          name: status
          schema:
            type: array
            items:
              type: string
              enum:
                - cancelling
                - deploy_failed
                - idle
                - inactive
                - pending_events
                - preparing
                - queued
                - running
          description: |-
            Multiple values may be separated by commas.

            * `pending_events` - PENDING_EVENTS
            * `preparing` - PREPARING
            * `queued` - QUEUED
            * `running` - RUNNING
            * `cancelling` - CANCELLING
            * `idle` - IDLE
            * `inactive` - INACTIVE
            * `deploy_failed` - DEPLOY_FAILED
          explode: false
          style: form
        - in: query
          name: tag
          schema:
            type: string
        - in: query
          name: updated_at__gt
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__gte
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__lt
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__lte
          schema:
            type: string
            format: date-time
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedDestinationList'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    PaginatedDestinationList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/Destination'
    Destination:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        is_ml_ai_connector:
          type: boolean
          readOnly: true
        slug:
          type: string
          readOnly: true
          pattern: ^[-a-zA-Z0-9_]+$
        archived:
          type: boolean
          readOnly: true
        deleted:
          type: boolean
          readOnly: true
        active:
          type: boolean
          readOnly: true
        status:
          type: string
          readOnly: true
        deploy_failed:
          type: boolean
          readOnly: true
        deploy_failed_reason:
          type: string
          readOnly: true
        connector_config:
          readOnly: true
        description:
          type: string
          readOnly: true
        input_tables:
          type: array
          items: {}
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        python_execution_cpu:
          type: integer
          readOnly: true
        python_execution_memory:
          type: integer
          readOnly: true
        settings_number_of_retries:
          type: integer
          readOnly: true
          description: The number of times to retry a task in the settings if it fails
        settings_retry_delay_seconds:
          type: integer
          readOnly: true
          title: Settings retry delay in seconds
          description: The number of seconds to retry a task in the settings if it fails
        settings_max_consecutive_failures:
          type: integer
          readOnly: true
          nullable: true
          description: >-
            The maximum number of consecutive failures allowed before the
            settings is paused
        connector_version:
          type: string
          readOnly: true
          description: Connector version used by this destination (Expandable)
        last_run:
          type: string
          readOnly: true
          description: Last Run from this destination (Expandable)
        created_by:
          type: integer
          readOnly: true
          description: User that created this destination (Expandable)
      required:
        - active
        - archived
        - connector_config
        - connector_version
        - created_at
        - created_by
        - deleted
        - deploy_failed
        - deploy_failed_reason
        - description
        - id
        - input_tables
        - is_ml_ai_connector
        - last_run
        - python_execution_cpu
        - python_execution_memory
        - settings_max_consecutive_failures
        - settings_number_of_retries
        - settings_retry_delay_seconds
        - slug
        - status
        - updated_at
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````