Skip to main content
GET
/
v2
/
people
List People
curl --request GET \
  --url https://api.opennous.cloud/v2/people
curl 'https://api.opennous.cloud/v2/people?pipeline_stage=interested&last_activity_after=7d&limit=50' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Query parameters

​
search
string
Substring match across email, first name, last name, company.
​
pipeline_stage
string
Exact match. One of identified, aware, interested, evaluating, client.
​
source
string
Exact match on the entity’s source claim.
​
status
string
Entity status. active (default) or archived.
​
has_email
boolean
Restrict to people who do or do not have an email identifier.
​
has_linkedin
boolean
Restrict to people who do or do not have a LinkedIn URL.
​
last_activity_before
string
Duration like 2d, 7d, 30d. Returns people whose last activity was before now minus the duration, including people who never had activity. Use this for the “gone quiet for N” filter inside a morning loop.
​
last_activity_after
string
Duration like 2d, 7d, 30d. Returns people active within the window.
​
sort
string
last_activity_desc (default) or last_activity_asc.
​
limit
integer
default:"100"
Page size. Max 1000.
​
offset
integer
default:"0"
Page offset.

​
Response

{
  "people": [
    {
      "id": "a1b2c3d4-...",
      "email": "sarah@acme.com",
      "first_name": "Sarah",
      "last_name": "Chen",
      "job_title": "VP Sales",
      "company": "Acme",
      "linkedin_url": "https://linkedin.com/in/sarah-chen",
      "pipeline_stage": "interested",
      "icp_score": 0.78,
      "last_activity_at": "2026-05-25T18:11:32Z"
    }
  ],
  "limit": 50,
  "offset": 0
}
id is the entity UUID. Pass it to GET /v2/accounts/:id, POST /v2/context, POST /v2/observations — anywhere the v2 surface accepts a focus. (POST and PATCH responses include both id and entity_id; they always carry the same value.)