---
title: "Read the evidence-backed distribution control plane"
method: GET
path: "/api/v2/distribution-plan"
tags: ["Workspace reads"]
---

# Read the evidence-backed distribution control plane

`GET /api/v2/distribution-plan`

## Request

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

Compiles approved Company Intelligence and measured Growth OS opportunities into ranked plays with exact existing MCP, REST and dashboard routes. The read makes no model or paid-provider call and never expands execution authority.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Tenant-pinned distribution plan.

- DistributionPlanResponse
  - `data` DistributionPlan, required
    - `version` 'distribution-plan-v1', required
    - `available` boolean, required
    - `generatedAt` string, date-time, required
    - `workspaceId` string, uuid, required
    - `status` 'ready' | 'needs_context' | 'needs_asset' | 'blocked' | 'unavailable', required
    - `headline` string, required
    - `summary` string, required
    - `coverage` object, required
      - `companyIntelligence` integer, required
      - `measuredDistribution` integer, required
      - `readyPlays` integer, required
      - `totalPlays` integer, required
    - `messageFrame` object, nullable, required
    - `plays` object[], required
    - `nextAction` object, required
    - `blockers` string[], required
    - `unsupportedChannels` object[], required
    - `sourceRevisions` object, required
      - `companyIntelligenceMemoryVersion` integer, required
      - `growthGeneratedAt` string, date-time, required
    - `truth` object, required
    - `cost` object, required
      - `modelCalls` 0, required
      - `paidProviderCalls` 0, required

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `409`: Current lifecycle state conflicts with the requested decision.
- `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)