Query

POST

query

curl --request POST \
  --url https://api.opennous.cloud/v2/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": {
    "property": "interaction.email_sent",
    "since_days": 5
  },
  "without": {
    "property": "interaction.email_replied",
    "since_days": 5
  },
  "return": "entities"
}
'

{
  "scope": {
    "property": "interaction.email_sent",
    "since_days": 5
  },
  "without": {
    "property": "interaction.email_replied",
    "since_days": 5
  },
  "mode": "structured",
  "return": "entities",
  "matched": 23,
  "returned": 23,
  "sampled": false,
  "items": [
    {
      "entity_id": "9b2f6c1e-4d3a-4f7e-9a51-2c8d7e3b1f40",
      "entity_name": "Sarah Chen",
      "matches": 2,
      "most_recent_at": "2026-09-28T09:00:00Z",
      "most_recent_type": "interaction.email_sent",
      "most_recent_source": "instantly",
      "most_recent_summary": "Follow-up on pricing"
    }
  ],
  "rollups": {
    "by_type": {
      "interaction.email_sent": 31
    },
    "by_source": {
      "instantly": 31
    }
  },
  "meta": {
    "token_estimate": 910
  },
  "question": null
}

Retrieves activity or facts across many accounts. OpenNous retrieves and compacts. Your agent finds the pattern.

Want	Send
One row per account	`return: "entities"`
Emailed but no reply	`scope` on `interaction.email_sent`, `without` on `interaction.email_replied`, same `since_days`
Funnel by stage	`scope: { kind: "state", property: "pipeline_stage" }` and read `rollups.by_value`
Meetings this week	`scope: { property: "interaction.meeting_scheduled", from, to, order: "asc" }`
Facts across accounts	`scope: { facts: true }` plus a `question`
Your worklist	`scope: { attention: "mine" }`
Objections and themes for a seat	`scope: { reporting: "role", role: "account_executive" }`
The ICP document	`scope: { foundation: "icp" }`

since_days only looks back. Use from and to for future-dated meetings.

Authorizations

Authorization

string

header

required

Workspace API key. Create one in Settings → API keys.

Body

application/json

scope

object

Show child attributes

without

object

Subtract entities matching this scope.

Show child attributes

return

enum<string>

default:observations

Available options:

observations,

entities

question

string

What you want to learn. Enables semantic ranking and is echoed back.

Response

The result. scope.reporting, scope.attention, and scope.foundation return their own shapes.

Option 1
Option 2
Option 3

scope

object

Show child attributes

without

object

Show child attributes

mode

enum<string>

Available options:

structured,

semantic

return

enum<string>

Available options:

observations,

entities

corpus

enum<string>

Available options:

observations,

facts

matched

integer

returned

integer

sampled

boolean

items

object[]

One row per observation, per entity, or per fact, depending on return and scope.facts.

rollups

object

Show child attributes

meta

object

Show child attributes

question

string | null

curl --request POST \
  --url https://api.opennous.cloud/v2/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": {
    "property": "interaction.email_sent",
    "since_days": 5
  },
  "without": {
    "property": "interaction.email_replied",
    "since_days": 5
  },
  "return": "entities"
}
'

{
  "scope": {
    "property": "interaction.email_sent",
    "since_days": 5
  },
  "without": {
    "property": "interaction.email_replied",
    "since_days": 5
  },
  "mode": "structured",
  "return": "entities",
  "matched": 23,
  "returned": 23,
  "sampled": false,
  "items": [
    {
      "entity_id": "9b2f6c1e-4d3a-4f7e-9a51-2c8d7e3b1f40",
      "entity_name": "Sarah Chen",
      "matches": 2,
      "most_recent_at": "2026-09-28T09:00:00Z",
      "most_recent_type": "interaction.email_sent",
      "most_recent_source": "instantly",
      "most_recent_summary": "Follow-up on pricing"
    }
  ],
  "rollups": {
    "by_type": {
      "interaction.email_sent": 31
    },
    "by_source": {
      "instantly": 31
    }
  },
  "meta": {
    "token_estimate": 910
  },
  "question": null
}

Overview

People

Accounts

Deals

Notes

Attention

Insights

Enrich & score

Organization

Workflows

Webhooks

Usage

Authorizations

Body

Response