Skip to main content
The leads endpoint returns prospects who matched your ICP and showed relevant intent. Each lead includes company details directly in the response so you can show who to contact and why the timing matters. 
curl --request POST \
  --url 'https://api.plyne.ai/v1/signals/leads' \
  --header 'Authorization: Bearer plyne_...' \
  --header 'Content-Type: application/json' \
  --data '{
    "signals": ["topic_engagement_signal"],
    "sheet_ids": ["sheet_123"],
    "lead_country_codes": ["US"],
    "company_country_codes": ["US"],
    "cursor": { "limit": 100 }
  }'

{
  "data": [
    {
      "id": "lead_123",
      "full_name": "Sarah Carter",
      "title": "Head of Engineering",
      "country_code": "US",
      "profile": {
        "platform": "linkedin",
        "url": "https://linkedin.com/in/sarah-carter"
      },
      "company": {
        "id": "company_123",
        "name": "Acme",
        "domain": "acme.com",
        "linkedin_url": "https://linkedin.com/company/acme",
        "country_code": "US"
      },
      "sheet": {
        "id": "sheet_123",
        "name": "AI infrastructure buyers"
      },
      "signal": {
        "id": "topic_engagement_signal",
        "name": "Post Engagers",
        "summary": "Engaged with relevant topic content recently",
        "reason": "Sarah engaged with content related to cloud infrastructure modernization.",
        "observed_at": "2026-06-15T08:00:00Z"
      }
    }
  ],
  "cursor": {
    "next": "",
    "has_more": false
  }
}

POST /v1/signals/leads

​
Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

​
Body

signalsstring[]

Filter by the signal that explains why the lead is relevant. See Accepted Filter Values.

Example: [“topic_engagement_signal”]

sheet_idsstring[]

Filter leads to one or more sheets configured in the dashboard.

Example: [“sheet_123”]

lead_idsstring[]

Return specific leads by ID.

Example: [“lead_123”]

company_idsstring[]

Filter leads to one or more companies.

Example: [“company_123”]

lead_country_codesstring[]

Filter by lead country code using two-letter country codes. See Accepted Filter Values.

Example: [“US”, “GB”]

company_country_codesstring[]

Filter by company country code using two-letter country codes. See Accepted Filter Values.

Example: [“US”, “CA”]

observedobject

Restrict results to when the signal was observed.

cursor.limitinteger

Number of leads to return per page.

Example: 100

cursor.afterstring

Opaque cursor returned as cursor.next from the previous response.