---
title: "List NodeJS builds"
method: GET
path: "/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds"
tags: ["Hosting: NodeJS"]
---

# List NodeJS builds

`GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds`

Retrieve a paginated list of Node.js build processes for a specific website.

Each build represents a single run of the Node.js build pipeline. Use the `states`
query parameter to filter results by build state (pending, running, completed, failed).
Use the `uuid` from a build to poll its output via the `Get Node.js Build Logs` endpoint.

## Path parameters

- `username` string, required
- `domain` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `states` string[]

## Response `200`

Success response

- object
  - `data` HostingV1NodeJsBuildResource[] — Array of [`Hosting.V1.NodeJs.BuildResource`](#model/hostingv1nodejsbuildresource)
    - `uuid` string — Build UUID
    - `state` 'pending' | 'running' | 'completed' | 'failed' — Build state
    - `options` HostingV1NodeJsBuildOptionsResource
      - `node_version` integer, required — Node.js version
      - `app_type` 'create-react-app' | 'gatsby' | 'vite' | 'angular' | 'react' | 'vue' | 'parcel' | 'next' | 'nuxt' | 'nest' | 'express' | 'fastify' | 'astro' | 'svelte' | 'svelte-kit' | 'hono' | 'react-router' | 'nitro' | 'other', nullable, required — Node.js application type
      - `root_directory` string, nullable, required — Application root directory
      - `output_directory` string, nullable, required — Build output directory
      - `build_script` string, nullable, required — The npm script to run to build the application
      - `entry_file` string, nullable, required — The main entry point file for the application
      - `package_manager` 'npm' | 'yarn' | 'pnpm', nullable, required — Package manager
      - `source_type` 'archive', nullable, required — Source type for the build
      - `source_options` HostingV1NodeJsSourceOptionsResource, required
        - `archive_path` string, nullable — Present if sourceType is "archive"
    - `created_at` string, date-time — Creation timestamp
    - `updated_at` string, date-time — Last update timestamp
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `500` — Error response

## Changes

- **2026-08-17** `0692bdc8e675` — 13 warning
  - added the new `astro` enum value to the `data/items/options/oneOf[#/components/schemas/Hosting.V1.NodeJs.BuildOptionsResource]/app_type` response property for the response status `200`
  - added the new `express` enum value to the `data/items/options/oneOf[#/components/schemas/Hosting.V1.NodeJs.BuildOptionsResource]/app_type` response property for the response status `200`
  - added the new `fastify` enum value to the `data/items/options/oneOf[#/components/schemas/Hosting.V1.NodeJs.BuildOptionsResource]/app_type` response property for the response status `200`
  - added the new `gatsby` enum value to the `data/items/options/oneOf[#/components/schemas/Hosting.V1.NodeJs.BuildOptionsResource]/app_type` response property for the response status `200`
  - …9 more

[Change history](https://skmtc.dev/hostinger/apis/hostinger-api/changes/api/hosting/v1/accounts/:username/websites/:domain/nodejs/builds/get.md)

---

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