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

# List Endpoints



## OpenAPI

````yaml api-reference/gpus-v2-spec/list-endpoint.json GET /gpus/v2/endpoints
openapi: 3.0.0
info:
  title: Novita GPU API v2
  version: 2.0.0
servers:
  - url: https://api.novita.ai
security: []
paths:
  /gpus/v2/endpoints:
    get:
      summary: List Endpoints
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: 'Bearer authentication format, e.g.: `Bearer {{API_KEY}}`.'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          description: Maximum number of items to return. Integer, value >= 0.
          example: 10
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: 'Pagination cursor. String, length: 0-1024 characters.'
          example: endpoint-cursor
        - name: keyword
          in: query
          required: false
          schema:
            type: string
          description: Search keyword.
          example: example
        - name: member_ids
          in: query
          required: false
          schema:
            type: string
          description: Filter by member ID. Multiple IDs are comma-separated.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Endpoint list
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Endpoint ID
                          example: endpoint-id
                        type:
                          type: string
                          enum:
                            - sync
                            - async
                          description: 'Endpoint type. Allowed values: `sync`, `async`'
                        name:
                          type: string
                          description: Endpoint name
                          example: example-endpoint
                        app_name:
                          type: string
                          description: Application name
                          example: example-app
                        status:
                          type: object
                          description: Endpoint status
                          properties:
                            status:
                              type: string
                              description: Status value
                              example: running
                            error:
                              type: string
                              description: Error code or error type
                              example: ''
                            message:
                              type: string
                              description: Status note or error message
                              example: ''
                        url:
                          type: string
                          description: Access URL
                          example: https://endpoint.example.com/endpoint-id
                        product_id:
                          type: string
                          description: Serverless product ID
                          example: product-id
                        worker_config:
                          type: object
                          description: Worker configuration
                          properties:
                            max_replicas:
                              type: integer
                              description: >-
                                Maximum number of workers. Integer, range: [0,
                                1000].
                              example: 2
                            min_replicas:
                              type: integer
                              description: >-
                                Minimum number of workers. Integer, range: [0,
                                1000].
                              example: 0
                            idle_timeout:
                              type: integer
                              description: 'Idle release timeout. Integer, range: [1, 1000].'
                              example: 300
                            max_concurrent_per_worker:
                              type: integer
                              description: >-
                                Maximum concurrent requests per worker. Integer,
                                range: [1, 1000].
                              example: 10
                            gpu_num:
                              type: integer
                              description: 'GPU count. Integer, range: [1, 8].'
                              example: 1
                            rootfs_size_gb:
                              type: integer
                              description: >-
                                Root disk size. Integer, range: [10, 100]. Unit:
                                GB.
                              example: 20
                            min_cuda_version:
                              type: string
                              enum:
                                - '12.4'
                                - '12.6'
                                - '12.8'
                                - '12.9'
                                - '13.0'
                              description: >-
                                Minimum CUDA version. Allowed values: `12.4`,
                                `12.6`, `12.8`, `12.9`, `13.0`.
                              example: '12.4'
                            request_timeout:
                              type: integer
                              description: 'Request timeout. Integer, range: [1, 1800].'
                              example: 60
                        policy:
                          type: object
                          description: Policy configuration
                          properties:
                            type:
                              type: string
                              enum:
                                - queue
                                - concurrency
                              description: >-
                                Policy type. Allowed values: `queue`,
                                `concurrency`.
                              example: queue
                            value:
                              type: integer
                              description: >-
                                Policy value. Integer, range: [1, 1000]. `queue`
                                measures queue wait time; `concurrency` measures
                                request count.
                              example: 100
                        image:
                          type: string
                          description: Image address
                          example: registry.example.com/namespace/image:tag
                        registry_auth_id:
                          type: string
                          description: Registry authentication ID
                          example: registry-auth-id
                        entrypoint:
                          type: string
                          description: Container entrypoint
                          example: ''
                        command:
                          type: string
                          description: Startup command
                          example: go run main.go
                        volumes:
                          type: array
                          description: Mount list
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: Storage ID.
                                example: storage-id
                              type:
                                type: string
                                enum:
                                  - local
                                  - network
                                description: >-
                                  Storage type. Allowed values: `local`,
                                  `network`. Note: the `local` type is being
                                  deprecated.
                                example: network
                              size:
                                type: integer
                                description: >-
                                  Storage size. Returned only when `type=local`.
                                  Note: the `local` type is being deprecated.
                              mount_point:
                                type: string
                                description: 'Mount path. String, length: 0-4095 characters.'
                                example: /data
                        envs:
                          type: array
                          description: Environment variable list
                          items:
                            type: object
                            properties:
                              key:
                                type: string
                                description: >-
                                  Variable name. String, length: 0-511
                                  characters.
                                example: ENV_NAME
                              value:
                                type: string
                                description: >-
                                  Variable value. String, length: 0-4095
                                  characters.
                                example: ENV_VALUE
                        ports:
                          type: array
                          items:
                            type: integer
                          description: Port list
                          example:
                            - 8080
                        workers:
                          type: array
                          description: Worker list
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: Worker ID
                                example: worker-id
                              status:
                                type: object
                                description: Worker status
                                properties:
                                  status:
                                    type: string
                                    description: Status value
                                    example: ready
                                  error:
                                    type: string
                                    description: Error code or error type
                                    example: ''
                                  message:
                                    type: string
                                    description: Status note or error message
                                    example: ''
                              log:
                                type: string
                                description: Worker log endpoint
                                example: https://logs.example.com/worker-id
                              health:
                                type: boolean
                                description: Whether the worker is healthy
                                example: true
                              drain:
                                type: boolean
                                description: Whether the worker stopped accepting requests
                                example: false
                        health_check:
                          type: object
                          description: Health check configuration
                          properties:
                            path:
                              type: string
                              description: Health check path.
                              example: /healthz
                            port:
                              type: integer
                              description: 'Health check port. Integer, range: [0, 65535].'
                              example: 8080
                        region_id:
                          type: string
                          description: Region ID
                          example: region-id
                        member_id:
                          type: string
                          description: Member ID
                          example: member-id
                        owner_id:
                          type: string
                          description: Owner ID
                          example: 550e8400-e29b-41d4-a716-446655440000
                        created_at:
                          type: integer
                          description: Creation time. Unix timestamp
                          example: 1710000000
                  next_cursor:
                    type: string
                    description: >-
                      Cursor for the next page. Empty string when there is no
                      next page
                    example: next-endpoint-cursor
                  has_more:
                    type: boolean
                    description: Whether there are more pages
                    example: true

````