---
title: "Read the measured demand-versus-conversion decision"
method: GET
path: "/api/v2/demand-radar"
tags: ["Workspace reads"]
---

# Read the measured demand-versus-conversion decision

`GET /api/v2/demand-radar`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/demand-radar`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns one evidence-backed operating mode and next action. Missing website traffic remains unknown; first-party page views are never conflated with eligible experiment sessions.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Tenant-pinned Demand Radar.

- DemandRadarResponse
  - `data` object, required
    - `version` 'demand-radar-v1', required
    - `generatedAt` string, date-time, required
    - `workspaceId` string, uuid, required
    - `available` boolean, required
    - `mode` 'unavailable' | 'needs_measurement' | 'create_demand' | 'capture_demand' | 'compound_growth', required
    - `headline` string, required
    - `reason` string, required
    - `traffic` object, required
      - `windowDays` 28, required
      - `websitePageViews` integer, nullable, required
      - `measured` boolean, required
      - `source` 'first_party_page_events', required
    - `demand` object, required
    - `conversion` object, required
    - `nextAction` object, required
      - `kind` string, required
      - `title` string, required
      - `reason` string, required
      - `dashboard` string, required
      - `mcp` string, required
      - `rest` string, required
      - `playId` string, nullable, required
    - `truth` object, required

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `429`: Request or durable protocol cap reached.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)