---
title: "Retrieves a list of nodes"
method: GET
path: "/nodes"
tags: ["Registry"]
---

# Retrieves a list of nodes

`GET /nodes`

Returns a paginated list of nodes across all publishers.

## Query parameters

- `page` integer
- `limit` integer
- `supported_os` string
- `supported_accelerator` string
- `include_banned` boolean
- `timestamp` string, date-time
- `latest` boolean
- `sort` string[]
- `node_id` string[]
- `comfyui_version` string
- `form_factor` string

## Response `200`

A paginated list of nodes

- object
  - `limit` integer — Maximum number of nodes per page
  - `nodes` Node[]
    - `author` string
    - `banner_url` string — URL to the node's banner.
    - `category` string — DEPRECATED: The category of the node. Use 'tags' field instead. This field will be removed in a future version.
    - `created_at` string, date-time — The date and time when the node was created
    - `description` string
    - `downloads` integer — The number of downloads of the node.
    - `github_stars` integer — Number of stars on the GitHub repository.
    - `icon` string — URL to the node's icon.
    - `id` string — The unique identifier of the node.
    - `latest_version` NodeVersion
      - `changelog` string — Summary of changes made in this version
      - `comfy_node_extract_status` string — The status of comfy node extraction process.
      - `createdAt` string, date-time — The date and time the version was created.
      - `dependencies` string[] — A list of pip dependencies required by the node.
      - `deprecated` boolean — Indicates if this version is deprecated.
      - `downloadUrl` string — [Output Only] URL to download this version of the node
      - `id` string
      - `node_id` string — The unique identifier of the node.
      - `status` 'NodeVersionStatusActive' | 'NodeVersionStatusDeleted' | 'NodeVersionStatusBanned' | 'NodeVersionStatusPending' | 'NodeVersionStatusFlagged'
      - `status_reason` string
      - `supported_accelerators` string[] — List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports
      - `supported_comfyui_frontend_version` string — Supported versions of ComfyUI frontend
      - `supported_comfyui_version` string — Supported versions of ComfyUI
      - `supported_os` string[] — List of operating systems that this node supports
      - `tags` string[]
      - `tags_admin` string[] — Admin-only tags for security warnings and admin metadata
      - `version` string — The version identifier, following semantic versioning. Must be unique for the node.
    - `license` string — The path to the LICENSE file in the node's repository.
    - `name` string — The display name of the node.
    - `preempted_comfy_node_names` string[] — A list of Comfy node names that are preempted by this node.
    - `publisher` Publisher
      - `createdAt` string, date-time — The date and time the publisher was created.
      - `description` string
      - `id` string — The unique identifier for the publisher. It's akin to a username. Should be lowercase.
      - `logo` string — URL to the publisher's logo.
      - `members` PublisherMember[] — A list of members in the publisher.
        - `id` string — The unique identifier for the publisher member.
        - `role` string — The role of the user in the publisher.
        - `user` PublisherUser
          - `email` string — The email address for this user.
          - `id` string — The unique id for this user.
          - `name` string — The name for this user.
      - `name` string
      - `source_code_repo` string
      - `status` 'PublisherStatusActive' | 'PublisherStatusBanned'
      - `support` string
      - `website` string
    - `rating` number — The average rating of the node.
    - `repository` string — URL to the node's repository.
    - `search_ranking` integer — A numerical value representing the node's search ranking, used for sorting search results.
    - `status` 'NodeStatusActive' | 'NodeStatusDeleted' | 'NodeStatusBanned'
    - `status_detail` string — The status detail of the node.
    - `supported_accelerators` string[] — List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports
    - `supported_comfyui_frontend_version` string — Supported versions of ComfyUI frontend
    - `supported_comfyui_version` string — Supported versions of ComfyUI
    - `supported_os` string[] — List of operating systems that this node supports
    - `tags` string[]
    - `tags_admin` string[] — Admin-only tags for security warnings and admin metadata
    - `translations` object — Translations of node metadata in different languages.
  - `page` integer — Current page number
  - `total` integer — Total number of nodes available
  - `totalPages` integer — Total number of pages available

## Other responses

- `400` — Invalid input, object invalid
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/ac/apis/comfy-api.md) · [All operations](https://skmtc.dev/ac/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ac/comfy-api/revisions/c1893dffe250/schema)