People
👤 People API
Search for people and retrieve their associated interview transcripts.
People Search
Get people with their associated transcripts.
Supports filtering by:
name: partial match on person nametitle: partial match on person titlecompany_id: only people linked to a specific companycompany_name: only people linked to a company by name
Each result includes the person's basic info and all their published transcripts with call date, post date, call type, and associated companies.
Search by person name (partial, case-insensitive)
Search by person title (partial, case-insensitive)
Filter by associated company ID
Search by associated company name (partial, case-insensitive)
Order results by field. Use '-' prefix for descending (e.g., 'name', '-name')
Page number (starts from 1)
1Number of items per page (max 100)
20Successful Response
Validation Error
GET /api/v1/people HTTP/1.1
Accept: */*
{
"data": [
{
"person_id": "123e4567-e89b-12d3-a456-426614174000",
"full_name": "text",
"title": "text",
"bio": "text",
"transcripts": [
{
"transcript_id": "123e4567-e89b-12d3-a456-426614174000",
"call_date": "2026-01-01",
"post_date": "2026-01-01",
"project_affiliation": "text",
"call_type": "text",
"companies": [
{
"company_id": "123e4567-e89b-12d3-a456-426614174000",
"company_name": "text",
"stock_ticker": "text",
"exchange": "text",
"isin": "text"
}
]
}
]
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total_items": 1,
"total_pages": 1,
"has_next": true,
"has_previous": true,
"next_page": 1,
"previous_page": 1
}
}📝 Description
The people endpoint allows you to search for experts and professionals in the database and retrieve all their associated interview transcripts. This endpoint supports:
Pagination: Control the number of results with
pageandper_pageparameters (max 100 per page)Name Filtering: Partial, case-insensitive search on the person's full name
Title Filtering: Partial, case-insensitive search on the person's job title
Company Filtering: Filter people by company using either
company_idorcompany_nameOrdering: Sort results by a field name, ascending or descending (e.g.
name,-name)
Search Types
Name Search:
"John"matches"John Smith","JOHN DOE", etc.Title Search:
"CEO"matches all people with CEO in their titleCompany Name Search:
"Apple"returns all people linked to Apple-related companiesCompany ID Search: Exact match on a known company UUID
Parameter Details
ordering Parameter
Use the field name for ascending order, or prefix with - for descending:
"name"— alphabetical A → Z"-name"— alphabetical Z → A
Response Structure
Each item in data includes:
person_id: Unique UUID for the personfull_name: Full display nametitle: Job title (nullable)bio: Biography text (nullable)transcripts: List of all published transcripts associated with this person, each containing:transcript_id,call_date,post_date,call_type,project_affiliationcompanies: List of companies associated with that transcript
Last updated