Skip to main content
GET
/
v2
/
leads
List Leads
curl --request GET \
  --url https://api.opennous.cloud/v2/leads
Lead Lists is a Scale-plan feature. 
curl 'https://api.opennous.cloud/v2/leads?list_id=LIST_UUID&status=sent&sent_before=2d&limit=100' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Query parameters

​
list_id
string
UUID of a single list. Omit to query across every list in the workspace.
​
status
string
Exact match. One of pending, sent, replied, bounced.
​
reply_outcome
string
One of interested, objection, wrong_fit, unsubscribe.
​
has_replied
boolean
true returns rows where replied_at is set. false returns rows still waiting.
​
has_email
boolean
Restrict by whether the row has an email.
​
sent_within
string
Duration like 2d, 7d. Returns rows sent within the window.
​
sent_before
string
Duration like 2d, 7d. Returns rows whose last send was before the cutoff, including rows that were never sent. Use this for “no outreach in N days” filters.
​
score_gte
number
Minimum scorecard_score (0..1).
​
sort
string
created_desc (default), created_asc, score_desc.
​
limit
integer
default:"100"
Page size. Max 1000.
​
offset
integer
default:"0"
Page offset.

​
Response

{
  "leads": [
    {
      "id": "9f1e...",
      "lead_list_id": "1234-...",
      "email": "sarah@acme.com",
      "name": "Sarah Chen",
      "company": "Acme",
      "linkedin_url": "https://linkedin.com/in/sarah-chen",
      "sent_at": "2026-05-23T08:01:11Z",
      "status": "sent",
      "reply_outcome": null,
      "scorecard_score": 0.78,
      "fields": { "title": "VP Sales", "industry": "SaaS" }
    }
  ],
  "limit": 100,
  "offset": 0
}