---
title: "Check whether a new daemon can be provisioned"
method: GET
path: "/api/v1/daemons/provision-eligibility"
tags: ["Daemons", "internal"]
---

# Check whether a new daemon can be provisioned

`GET /api/v1/daemons/provision-eligibility`

## Request

- Base URL: `https://app.scanopy.net`
- URL: `https://app.scanopy.net/api/v1/daemons/provision-eligibility`
- Auth: one of:
  - API key in header `Authorization`
  - API key in cookie `session_id`

The create wizard reads this before its first step, so a refusal from `POST /provision`
(no verified owner and a daemon already exists) stops the user up front rather than after
they have configured everything. Reads only the caller's own organization.

## Response `200`

Provisioning eligibility

- ApiResponseProvisionEligibility: Envelope for a successful response. Failures are sent with a non-2xx status and an `ApiErrorResponse` body instead.
  - `data` object: Whether provisioning another daemon would be refused for the caller's organization.
    - `email_verification_required` boolean, required: The organization already has a daemon and no owner has verified their email, so a new daemon is refused until one does.
    - `plan_required` boolean, required: The organization already has a daemon and is on Free, which runs one, so a new daemon is refused until it chooses a plan.
  - `error` string, nullable: Not sent on a successful response. Failure messages arrive in an `ApiErrorResponse`.
  - `meta` ApiMeta, required: API metadata included in all responses
    - `api_version` integer, required: API version (integer, increments on breaking changes)
    - `server_version` string, required: Server version (semver)
  - `success` boolean, required: Always `true` on a successful response.

## Changes

- **2026-10-26** `4c9bb86fcac6`: 1 info
  - added the required property `data/plan_required` to the response with the `200` status
- **2026-10-14** `0af8bb34da38`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/v1/daemons/provision-eligibility/get.md)

---

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