---
title: "List all node versions given some filters."
method: GET
path: "/versions"
tags: ["Versions"]
---

# List all node versions given some filters.

`GET /versions`

## Query parameters

- `nodeId` string
- `statuses` NodeVersionStatus[]
- `include_status_reason` boolean
- `page` integer
- `pageSize` integer

## Response `200`

List of all node versions

- object
  - `total` integer — Total number of node versions available
  - `versions` NodeVersion[]
    - `id` string
    - `version` string — The version identifier, following semantic versioning. Must be unique for the node.
    - `createdAt` string, date-time — The date and time the version was created.
    - `changelog` string — Summary of changes made in this version
    - `dependencies` string[] — A list of pip dependencies required by the node.
    - `downloadUrl` string — [Output Only] URL to download this version of the node
    - `deprecated` boolean — Indicates if this version is deprecated.
    - `status` 'NodeVersionStatusActive' | 'NodeVersionStatusDeleted' | 'NodeVersionStatusBanned' | 'NodeVersionStatusPending' | 'NodeVersionStatusFlagged'
    - `status_reason` string — The reason for the status change.
    - `node_id` string — The unique identifier of the node.
  - `page` integer — Current page number
  - `pageSize` integer — Maximum number of node versions per page. Maximum is 100.
  - `totalPages` integer — Total number of pages available

## Other responses

- `400` — Invalid input, object invalid
- `403` — Node banned
- `500` — Internal server error

## Changes

- **2025-01-23** `0caacf7dfa8f` — 1 warning
  - removed the optional property `versions/items/comfy_nodes` from the response with the `200` status
- **2025-01-11** `c83a221f1f42` — 1 breaking
  - the `versions/items/comfy_nodes/additionalProperties/return_names` response's property type/format changed from `array`/`` to `string`/`` for status `200`
- **2025-01-04** `080881edb9d7` — 1 info
  - added the non-success response with the status `400`
- **2025-01-04** `1aa47fe33bc6` — 1 info
  - added the optional property `versions/items/node_id` to the response with the `200` status
- **2024-12-31** `effe73f210a7` — 1 breaking
  - the `versions/items/comfy_nodes/additionalProperties/return_types` response's property type/format changed from `array`/`` to `string`/`` for status `200`

[Full history](https://skmtc.dev/comfy-org/apis/comfy-api/changes/versions/get.md)

---

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