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

# List nodes

> Public endpoint. Returns NodeRef list derived from nodes table (excluding deleted).



## OpenAPI

````yaml /openapi.json get /api/v1/attestations/nodes
openapi: 3.1.0
info:
  title: Phala Cloud API
  version: 0.1.0
servers:
  - url: https://cloud-api.phala.com
security: []
tags:
  - name: CVMs
    description: Confidential Virtual Machine (CVM) lifecycle management on Phala Network
  - name: Apps
    description: App template management and CVM deployment from app blueprints
  - name: Webhooks
    description: Manage webhook endpoints and monitor delivery history
  - name: SSH Keys
    description: SSH public key management for CVM access
  - name: KMS
    description: >-
      Key Management Service — key derivation, on-chain anchoring, and
      inspection
  - name: Instance Types
    description: Available hardware configurations for CVM deployment
  - name: Attestations
    description: Remote attestation and TEE verification endpoints
paths:
  /api/v1/attestations/nodes:
    get:
      tags:
        - Attestations
      summary: List nodes
      description: >-
        Public endpoint. Returns NodeRef list derived from nodes table
        (excluding deleted).
      operationId: handle_list_nodes_api_v1_attestations_nodes_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/NodeRef'
                type: array
                title: Response Handle List Nodes Api V1 Attestations Nodes Get
components:
  schemas:
    NodeRef:
      properties:
        object_type:
          type: string
          const: node
          title: Object Type
          description: Fixed value 'node'
          default: node
        id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Id
          description: Teepod numeric ID
        node_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Node Id
          description: Physical node numeric ID
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: Node display name
        region:
          anyOf:
            - type: string
            - type: 'null'
          title: Region
          description: Region identifier
        device_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Device Id
          description: Device ID
        ppid:
          anyOf:
            - type: string
            - type: 'null'
          title: Ppid
          description: PPID
        status:
          anyOf:
            - $ref: '#/components/schemas/TeepodStatus'
            - type: 'null'
          description: Node status
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
          description: Teepod version
      type: object
      title: NodeRef
      description: Minimal node/teepod reference for embedding in responses.
    TeepodStatus:
      type: string
      enum:
        - ONLINE
        - OFFLINE
        - MAINTENANCE
      title: TeepodStatus

````