Skip to main content
GET
/
api
/
deep-research
/
people
List deep research people
curl --request GET \
  --url https://app.puffle.ai/api/deep-research/people \
  --header 'Authorization: Bearer <token>'
{
  "people": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "user_id": "22222222-2222-2222-2222-222222222222",
      "first_name": "Jane",
      "last_name": "Smith",
      "linkedin_url": "https://www.linkedin.com/in/janesmith",
      "role": "VP of Engineering",
      "company": "Acme Corp",
      "company_domain": "acme.com",
      "photo_url": null,
      "status": "complete",
      "last_enriched_at": "2026-04-21T18:00:00Z",
      "created_at": "2026-04-21T17:55:00Z",
      "updated_at": "2026-04-21T18:00:00Z"
    }
  ]
}

Overview

Return every deep research person owned by the authenticated user, ordered by created_at DESC. Use this to render a list UI or to locate the id for a subsequent run/report call. Internal UI endpoint — for programmatic partner access use listResearchV1.
This operation shares the URL path /api/deep-research/people with other verbs. See the sibling page for related operations on the same resource.

Authorizations

Authorization
string
header
required

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

Response

People list.

people
object[]
required

All people owned by the caller, newest first.