Skip to main content
GET
/
api
/
v2
/
insights
/
entity-stats
Entity Stats
curl --request GET \
  --url https://app.octavehq.com/api/v2/insights/entity-stats \
  --header 'api_key: <api-key>'
{
  "data": {
    "anchorAt": "<string>",
    "week": {
      "oId": "<string>",
      "entityOId": "<string>",
      "periodStart": "<string>",
      "periodEnd": "<string>",
      "wonDealCount": 123,
      "lostDealCount": 123,
      "noDecisionDealCount": 123,
      "openDealCount": 123,
      "wonDealTotalAmount": "<string>",
      "lostDealTotalAmount": "<string>",
      "totalFindingCount": 123,
      "uniqueEventCount": 123,
      "uniqueCompanyCount": 123,
      "uniqueContactCount": 123,
      "winRate": 123,
      "relativeWinRate": 123,
      "liftScore": 123,
      "winRateDelta": 123,
      "isUbiquitous": true,
      "dealsWherePresent": 123,
      "dealsWhereAbsent": 123,
      "lastComputedAt": "<string>"
    },
    "month": {
      "oId": "<string>",
      "entityOId": "<string>",
      "periodStart": "<string>",
      "periodEnd": "<string>",
      "wonDealCount": 123,
      "lostDealCount": 123,
      "noDecisionDealCount": 123,
      "openDealCount": 123,
      "wonDealTotalAmount": "<string>",
      "lostDealTotalAmount": "<string>",
      "totalFindingCount": 123,
      "uniqueEventCount": 123,
      "uniqueCompanyCount": 123,
      "uniqueContactCount": 123,
      "winRate": 123,
      "relativeWinRate": 123,
      "liftScore": 123,
      "winRateDelta": 123,
      "isUbiquitous": true,
      "dealsWherePresent": 123,
      "dealsWhereAbsent": 123,
      "lastComputedAt": "<string>"
    },
    "quarter": {
      "oId": "<string>",
      "entityOId": "<string>",
      "periodStart": "<string>",
      "periodEnd": "<string>",
      "wonDealCount": 123,
      "lostDealCount": 123,
      "noDecisionDealCount": 123,
      "openDealCount": 123,
      "wonDealTotalAmount": "<string>",
      "lostDealTotalAmount": "<string>",
      "totalFindingCount": 123,
      "uniqueEventCount": 123,
      "uniqueCompanyCount": 123,
      "uniqueContactCount": 123,
      "winRate": 123,
      "relativeWinRate": 123,
      "liftScore": 123,
      "winRateDelta": 123,
      "isUbiquitous": true,
      "dealsWherePresent": 123,
      "dealsWhereAbsent": 123,
      "lastComputedAt": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
api_key
string
header
required

Query Parameters

​
entityType
enum<string>
required

Type of entity to query stats for

Available options:
persona,
product,
service,
solution,
use_case,
playbook,
proof_point,
competitor,
alternative,
buying_trigger,
objection,
reference,
hypothesis,
segment,
target_icp,
motion_icp
​
entityOId
string
required

The oId of the entity

​
anchorAt
string<date-time>

Anchor ISO datetime for period resolution. Defaults to now.

Response

200 - application/json

Win rate and lift stats for a single entity across period windows

​
data
object
required