---
title: "Read the shared human-and-agent Revenue Twin"
method: GET
path: "/api/v2/revenue-twin"
tags: ["Workspace reads"]
---

# Read the shared human-and-agent Revenue Twin

`GET /api/v2/revenue-twin`

## Request

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

Returns the tenant-pinned, evidence-hashed business, demand, conversion, revenue and memory read model. Current public tag verification is included; configured state alone never produces a live claim.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Tenant-pinned Revenue Twin.

- RevenueTwinResponse
  - `data` object, required
    - `version` 'revenue-twin-v1', required
    - `generatedAt` string, date-time, required
    - `workspaceId` string, uuid, required
    - `available` boolean, required
    - `evidenceHash` string, required
    - `lifecycle` object, required
    - `company` object, required
    - `buyers` object, required
    - `offer` object, required
    - `demand` object, required
    - `conversion` object, required
    - `memory` object, required
    - `connections` object, required
    - `blockers` object[], required
      - `key` string, required
      - `reason` string, required
      - `href` string, 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)