Get Account

curl --request GET \
  --url https://api.opennous.cloud/v2/accounts/{id}

import requests

url = "https://api.opennous.cloud/v2/accounts/{id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.opennous.cloud/v2/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/accounts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/accounts/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.opennous.cloud/v2/accounts/{id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/accounts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

accounts

{id}

Get Account

curl --request GET \
  --url https://api.opennous.cloud/v2/accounts/{id}

import requests

url = "https://api.opennous.cloud/v2/accounts/{id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.opennous.cloud/v2/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/accounts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/accounts/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.opennous.cloud/v2/accounts/{id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/accounts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

The raw projection. Returns every known fact about an entity, each with its source, freshness, and confidence, plus the recent activity timeline. Use this when you want the complete picture; prefer /v2/context for task-shaped, ranked output.

Request

curl https://api.opennous.cloud/v2/accounts/sarah%40acme.com \
  -H 'Authorization: Bearer YOUR_API_KEY'

Path params

string

required

URL-encoded identifier — entity UUID, email, domain, LinkedIn URL, or name. Names may return candidates.

Response

{
  "entity": {
    "id": "a1b2c3d4-...",
    "type": "person",
    "name": "Sarah Chen",
    "primary_identifier": "sarah@acme.com",
    "created_at": "2026-04-12T09:31:00Z"
  },
  "identifiers": [
    { "kind": "email",        "value": "sarah@acme.com" },
    { "kind": "linkedin_url", "value": "https://linkedin.com/in/sarahchen" }
  ],
  "claims": [
    {
      "property": "title",
      "value": "VP Sales",
      "confidence": 0.92,
      "freshness": "fresh",
      "epistemic_class": "observed",
      "sources": ["hubspot", "linkedin"],
      "valid_from": "2026-05-01T...",
      "last_observed_at": "2026-05-21T..."
    },
    {
      "property": "stage",
      "value": "evaluating",
      "confidence": 0.81,
      "freshness": "fresh",
      "epistemic_class": "derived",
      "sources": ["gmail", "fireflies"]
    }
  ],
  "recent_observations": [
    {
      "kind": "event",
      "property": "interaction.email_replied",
      "observed_at": "2026-05-21T15:00:00Z",
      "value": { "subject": "Re: Q3 pricing", "snippet": "Interested but…" }
    }
  ]
}

recent_observations is truncated to the most recent 50 events. Treat counts derived from it (number of replies, messages, etc.) as lower bounds, not totals. For accurate counts across a longer window or many entities, use POST /v2/query.

Claim shapes worth knowing

Most claims hold a simple scalar value ("VP Sales", "evaluating", 0.78). A few hold structured objects — read these as nested rather than flat. The big one is channels, which carries per-channel state for LinkedIn, email, and anything else Nous tracks per-contact:

{
  "property": "channels",
  "value": {
    "linkedin": {
      "url": "https://www.linkedin.com/in/sarah-chen",
      "state": "connected",
      "member_id": "ACoAA...",
      "connected_at": "2026-05-18T18:50:13Z",
      "synced_at": "2026-05-27T09:00:00Z"
    },
    "email": {
      "state": "active",
      "last_bounced_at": null
    }
  }
}

So adapters reading “is this person connected on LinkedIn?” should look at claims.channels.value.linkedin.state === 'connected', not a flat linkedin.state claim. New channels get added under the same value object as integrations land.

Ambiguous focus

Same shape as /v2/context:

{ "status": "ambiguous", "candidates": [ ... ] }

When to call it

“What do we know about X?” type questions
Building an audit / debug view of a contact
Inspecting epistemic_class and sources to understand WHY a claim is held

For action-oriented context (drafting outreach, prepping a meeting), prefer /v2/context — it returns less, but ranked for the task.

Get Context Record Observations

Overview

Account Context

Observations

People

Leads

Search

Workspace

Notes

Triggers

Get Account

Request

Path params

Response

Claim shapes worth knowing

Ambiguous focus

When to call it

​Request

​Path params

​Response

​Claim shapes worth knowing

​Ambiguous focus

​When to call it

Request

Path params

Response

Claim shapes worth knowing

Ambiguous focus

When to call it