Skip to main content
POST
/
v2
/
notes
/
search
Search Notes
curl --request POST \
  --url https://api.opennous.cloud/v2/notes/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "focus": "<string>",
  "limit": 123
}
'
The retrieval counterpart to POST /v2/notes. Semantically searches the meeting briefs, transcripts, meeting notes, and notes kept on contacts, and returns the matching documents with a snippet — so a workflow pulls the relevant passage rather than the whole document. Pass focus to restrict to one person or company, or omit it to search across everyone in the workspace.

​
Request

curl -X POST https://api.opennous.cloud/v2/notes/search \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "question": "what did we discuss about pricing",
    "focus": "sarah@acme.com",
    "limit": 8
  }'

​
Body

​
question
string
required
Natural-language query matched against document content.
​
focus
string
Restrict to one person/company — entity UUID, email, domain, or LinkedIn URL. Omit to search across everyone. A focus that can’t be resolved falls back to a workspace-wide search (it never creates an entity).
​
limit
number
default:"8"
Max documents to return. Cap 20.

​
Response

{
  "documents": [
    {
      "entity_id": "a1b2c3d4-...",
      "type": "meeting_notes",
      "title": "Q3 renewal call",
      "date": "2026-05-30",
      "similarity": 0.88,
      "snippet": "Sarah pushed back on per-seat — wants a flat platform fee. Maria (CFO) to…"
    },
    {
      "entity_id": "a1b2c3d4-...",
      "type": "meeting_brief",
      "title": "Pre-meeting brief — renewal",
      "date": "2026-06-01",
      "similarity": 0.74,
      "snippet": "Budget waiting on Q3 close; proposal at $12k/yr, expect a discount ask…"
    }
  ],
  "count": 2
}
snippet is truncated to ~400 characters. To read a document in full, fetch the contact with GET /v2/accounts/:id.

​
When to call it

  • “What did we discuss about pricing?” — pull the relevant past notes
  • “What objections came up in past meetings?” — across a contact’s record
  • Comparing across a contact’s meetings — set focus and read the snippets

​
Errors

StatusErrorWhat to do
400question requiredA non-empty question is required
401unauthorizedAPI key missing or invalid