Skip to Content
Drip Docs
API referencePeople

Get a person

A person by id or person:<id>. Omit limit for 25, or 10 when detail is full.

GET
/v1/people/{id}

A person by id or person:. Omit limit for 25, or 10 when detail is full.

Authorization

bearerAuth
headerAuthorizationBearer <drip_live>

An API key from Drip settings. Send it as Authorization: Bearer drip_live_… . The key is shown once.

Path Parameters

id*string

Person id, or person:.

Query Parameters

workspace_id?integer

Workspace id. Required when the account has more than one.

since?string

YYYY-MM-DD or a relative window. Default 30d.

until?string

End of the window. Defaults to now.

cursor?string

next_cursor from a previous page of updates.

limit?integer

Page size.

include_profile?boolean

False returns only updates.

detail?string

headlines, compact (default) or full.

Response Body

status ok, no_results, no_material_updates, partial or not_covered. Branch on status.

application/json
  1. response
appearances_in_window?number
count*number
coverage*
has_more*boolean
next_cursor*null|string
other_matches*null
person?
popularity?
roles?array<>
scope*
standing?array<>
status*string
total*number
updates*array<>
window*
Example Request
curl -X GET 'https://api.joindrip.ai/v1/people/string'
Example Response
{  "appearances_in_window": 0,  "count": 0,  "coverage": {    "note": null  },  "has_more": true,  "next_cursor": null,  "other_matches": null,  "person": {    "bio": "string",    "company": {      "id": 0,      "name": "string"    },    "functions": [      "string"    ],    "id": 0,    "linkedin": "string",    "name": "string",    "seniority": "string",    "title": "string"  },  "popularity": {    "mentions_30d": 0,    "trending": "string"  },  "roles": [    {      "company": {        "id": 0,        "name": "string"      },      "started": "string",      "status": "string",      "title": "string"    }  ],  "scope": {    "person": "string",    "tool": "string"  },  "standing": [    {      "authority_30d": 0,      "function": "string",      "mentions_30d": 0    }  ],  "status": "string",  "total": 0,  "updates": [    {      "categories": [        "string"      ],      "date": "string",      "evidence": [        {          "description_card": "string",          "entities": [            {              "company": "string",              "domain": "string",              "id": 0,              "name": "string",              "role": "string",              "ticker": "string",              "title": "string",              "type": "string"            }          ],          "event_date": "string",          "evidence_id": "string",          "headline": "string",          "key_points": [            "string"          ],          "kind": "string",          "linked_text": "string",          "source_count": 0,          "sources": [            {              "is_primary": true,              "outlet": "string",              "published": "string",              "source_type": "string",              "title": "string",              "url": "string"            }          ],          "type": "string"        }      ],      "headline": "string",      "kind": "string",      "summary": "string",      "thread": "string",      "update_id": "string"    }  ],  "window": {    "date_basis": "string",    "since": "string",    "until": "string"  }}