---
title: "Get project daemons"
method: GET
path: "/v1/projects/{idOrName}/daemons"
tags: ["daemons"]
---

# Get project daemons

`GET /v1/projects/{idOrName}/daemons`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/projects/{idOrName}/daemons`
- Auth: HTTP bearer

List the daemons of a project.

## Path parameters

- `idOrName` string, required: The unique project identifier or the project name

## Query parameters

- `limit` string: Maximum daemons to return (default: 10, max: 100)
- `cursor` string: Pagination cursor
- `scopeType` 'target' | 'branch' | 'customEnvironment': Filter by scope type
- `scopeValue` string: Filter by scope value (requires scopeType)
- `teamId` string
- `slug` string

## Response `200`

The daemons of the project and the pagination details.

- object
  - `daemons` object[], required
    - `config` object, required
      - `command` string[]
      - `configuredInstances` union
        - number
        - object: Configured instances before the overrides. Present only when overrides exist.
      - `image` object, required
        - `requested` string, required
        - `resolved` string, required
      - `instances` union, required
        - number
        - object
      - `livenessProbe` object
        - `failureThreshold` number
        - `httpGet` object, required
          - `host` string
          - `httpHeaders` object[]
            - `name` string, required
            - `value` string, required
          - `path` string, required
          - `port` number, required
          - `scheme` 'HTTP' | 'HTTPS', required
        - `initialDelaySeconds` number
        - `periodSeconds` number
        - `successThreshold` number
        - `timeoutSeconds` number
      - `resources` object, required
        - `requests` object, required
          - `memory` string, required
      - `terminationGracePeriodSeconds` number
    - `createdAt` string, required
    - `deploymentId` string: The deployment whose daemons this configuration comes from. Absent for daemons managed through the daemons API.
    - `instances` object, required
      - `desired` number, required
      - `items` object[], required
        - `alive` false | true
        - `id` string, required
        - `image` string
        - `lastCheckedAt` string
        - `memoryMiB` number
        - `region` string, required
        - `startedAt` string, required
        - `stoppedAt` string
      - `ready` number, required
      - `total` number, required
    - `name` string, required
    - `scope` union, required
      - object
        - `type` 'target', required
        - `value` 'development' | 'preview' | 'production', required
      - object
        - `type` 'branch', required
        - `value` string, required
      - object
        - `type` 'customEnvironment', required
        - `value` string, required
    - `status` 'ready' | 'reconciling' | 'stopped', required
    - `updatedAt` string, required
  - `pagination` object, required
    - `count` number, required
    - `next` string

## Other responses

- `400`: One of the provided values in the request query is invalid. The scope filter is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-10-21** `de74ecd152f7`: 2 breaking, 1 warning, 3 info
  - removed the required property `daemons/items/config/replicas` from the response with the `200` status
  - removed the required property `daemons/items/replicas` from the response with the `200` status
  - removed the optional property `daemons/items/config/configuredReplicas` from the response with the `200` status
  - added the optional property `daemons/items/config/configuredInstances` to the response with the `200` status
  - …2 more
- **2026-10-20** `ca001b656ead`: 2 warning
  - removed the optional property `daemons/items/config/image/vhs` from the response with the `200` status
  - removed the optional property `daemons/items/replicas/items/items/iroh` from the response with the `200` status
- **2026-10-19** `b4c010d0e737`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v1/projects/:idOrName/daemons/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)