This endpoint uses the People Database People object.
Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
curl --request GET \
--url https://api.lemlist.com/api/schema/people \
--header 'Authorization: Basic <encoded-value>'{
"schema": {
"lead_id": 231488528,
"canonical_shorthand_name": "john-doe",
"connections_count": 500,
"country": "United States",
"full_name": "John Doe",
"education": [
{
"activities_and_societies": "ACM, AI Club",
"created": "2020-08-15T00:00:00.000Z",
"date_from": "2016-09-01",
"date_to": "2020-06-01",
"deleted": "",
"description": "BSc in Computer Science",
"id": "edu_1",
"last_updated": "2021-08-15T00:00:00.000Z",
"member_id": "mem_123",
"school_url": "https://www.stanford.edu/",
"subtitle": "School of Engineering",
"title": "Stanford University"
}
],
"experience_count": 2,
"experiences": [
{
"company_id": 123456,
"company_description": "AI-powered customer engagement platform",
"company_employee_count": 250,
"company_followers_count": 5000,
"company_founded": 2015,
"company_headquarters_city": "San Francisco",
"company_headquarters_country": "United States",
"company_industry": "Computer Software",
"company_linkedin_url": "https://www.linkedin.com/company/techcorp/",
"company_logo_url": "https://example.com/logo.png",
"company_name": "TechCorp Inc.",
"company_size": "201-500 employees",
"company_type": "Privately Held",
"company_url": "https://www.techcorp.com",
"company_website_url": "https://www.techcorp.com",
"revenue_bucket": "$50M - $100M",
"company_domain": "techcorp.com",
"employees_count_growth": 18,
"last_funding_round_at": "2022-06-01",
"business_business_customer": "B2B",
"current_exp_bucket": "3-5 years",
"created": "2021-01-10T00:00:00.000Z",
"date_from": "2020-02-01",
"date_to": "",
"description": "Leading ML feature teams and MLOps initiatives",
"duration": "4 yrs",
"id": "exp_1",
"last_updated": "2024-09-01T00:00:00.000Z",
"location": "San Francisco Bay Area",
"member_id": "mem_123",
"order_in_profile": 0,
"title": "Senior Machine Learning Engineer",
"title_normalized": "Machine Learning Engineer",
"main_in_profile": true
},
{
"company_id": 98765,
"company_description": "Cloud infrastructure and developer tools",
"company_employee_count": 1500,
"company_followers_count": 20000,
"company_founded": 2010,
"company_headquarters_city": "Seattle",
"company_headquarters_country": "United States",
"company_industry": "Information Technology",
"company_linkedin_url": "https://www.linkedin.com/company/cloudco/",
"company_logo_url": "https://example.com/logo2.png",
"company_name": "CloudCo",
"company_size": "1001-5000 employees",
"company_type": "Public Company",
"company_url": "https://www.cloudco.com",
"company_website_url": "https://www.cloudco.com",
"revenue_bucket": ">$1B",
"company_domain": "cloudco.com",
"employees_count_growth": 25,
"last_funding_round_at": "2019-05-01",
"business_business_customer": "B2B",
"current_exp_bucket": "1-2 years",
"created": "2018-07-10T00:00:00.000Z",
"date_from": "2018-07-01",
"date_to": "2020-01-01",
"description": "Worked on distributed systems and observability",
"duration": "1 yr 6 mos",
"id": "exp_2",
"last_updated": "2020-01-10T00:00:00.000Z",
"location": "Seattle, WA",
"member_id": "mem_123",
"order_in_profile": 1,
"title": "Software Engineer",
"title_normalized": "Software Engineer",
"main_in_profile": false
}
],
"interests": [
{
"interest": "Artificial Intelligence",
"interest_id": "int_ai"
},
{
"interest": "Open Source",
"interest_id": "int_oss"
}
],
"languages": [
{
"language": "English",
"proficiency": "native"
},
{
"language": "French",
"proficiency": "professional"
}
],
"last_updated": "2024-10-31T12:00:00.000Z",
"lead_industry": "Computer Software",
"lead_linkedin_url": "https://www.linkedin.com/in/john-doe/",
"lead_logo_url": "https://example.com/john.png",
"linkedin_short": "john-doe",
"location": "San Francisco Bay Area",
"skills": [
{
"skill": "Machine Learning",
"skill_id": "sk_ml"
},
{
"skill": "Python",
"skill_id": "sk_py"
},
{
"skill": "MLOps",
"skill_id": "sk_mlops"
}
],
"summary": "Engineer focused on building ML systems that ship to production.",
"title": "Senior Machine Learning Engineer",
"lead_quality_score": 87,
"seniority": "senior",
"department": "engineering",
"connections_count_bucket": "500+",
"years_of_exp_bucket": "6-10 years",
"current_exp_company_name": "TechCorp Inc.",
"geopoint": [
37.7749,
-122.4194
],
"_score": 0.98123,
"_id": "people_abc123"
},
"version": {
"since": 20241031,
"type": "date"
},
"properties": [
"lead_id",
"canonical_shorthand_name",
"connections_count",
"country",
"full_name",
"education",
"experience_count",
"experiences",
"interests",
"languages",
"last_updated",
"lead_industry",
"lead_linkedin_url",
"lead_logo_url",
"linkedin_short",
"location",
"skills",
"summary",
"title",
"lead_quality_score",
"seniority",
"department",
"connections_count_bucket",
"years_of_exp_bucket",
"current_exp_company_name",
"geopoint",
"_score",
"_id"
]
}Get the schema definition for people in the database
curl --request GET \
--url https://api.lemlist.com/api/schema/people \
--header 'Authorization: Basic <encoded-value>'{
"schema": {
"lead_id": 231488528,
"canonical_shorthand_name": "john-doe",
"connections_count": 500,
"country": "United States",
"full_name": "John Doe",
"education": [
{
"activities_and_societies": "ACM, AI Club",
"created": "2020-08-15T00:00:00.000Z",
"date_from": "2016-09-01",
"date_to": "2020-06-01",
"deleted": "",
"description": "BSc in Computer Science",
"id": "edu_1",
"last_updated": "2021-08-15T00:00:00.000Z",
"member_id": "mem_123",
"school_url": "https://www.stanford.edu/",
"subtitle": "School of Engineering",
"title": "Stanford University"
}
],
"experience_count": 2,
"experiences": [
{
"company_id": 123456,
"company_description": "AI-powered customer engagement platform",
"company_employee_count": 250,
"company_followers_count": 5000,
"company_founded": 2015,
"company_headquarters_city": "San Francisco",
"company_headquarters_country": "United States",
"company_industry": "Computer Software",
"company_linkedin_url": "https://www.linkedin.com/company/techcorp/",
"company_logo_url": "https://example.com/logo.png",
"company_name": "TechCorp Inc.",
"company_size": "201-500 employees",
"company_type": "Privately Held",
"company_url": "https://www.techcorp.com",
"company_website_url": "https://www.techcorp.com",
"revenue_bucket": "$50M - $100M",
"company_domain": "techcorp.com",
"employees_count_growth": 18,
"last_funding_round_at": "2022-06-01",
"business_business_customer": "B2B",
"current_exp_bucket": "3-5 years",
"created": "2021-01-10T00:00:00.000Z",
"date_from": "2020-02-01",
"date_to": "",
"description": "Leading ML feature teams and MLOps initiatives",
"duration": "4 yrs",
"id": "exp_1",
"last_updated": "2024-09-01T00:00:00.000Z",
"location": "San Francisco Bay Area",
"member_id": "mem_123",
"order_in_profile": 0,
"title": "Senior Machine Learning Engineer",
"title_normalized": "Machine Learning Engineer",
"main_in_profile": true
},
{
"company_id": 98765,
"company_description": "Cloud infrastructure and developer tools",
"company_employee_count": 1500,
"company_followers_count": 20000,
"company_founded": 2010,
"company_headquarters_city": "Seattle",
"company_headquarters_country": "United States",
"company_industry": "Information Technology",
"company_linkedin_url": "https://www.linkedin.com/company/cloudco/",
"company_logo_url": "https://example.com/logo2.png",
"company_name": "CloudCo",
"company_size": "1001-5000 employees",
"company_type": "Public Company",
"company_url": "https://www.cloudco.com",
"company_website_url": "https://www.cloudco.com",
"revenue_bucket": ">$1B",
"company_domain": "cloudco.com",
"employees_count_growth": 25,
"last_funding_round_at": "2019-05-01",
"business_business_customer": "B2B",
"current_exp_bucket": "1-2 years",
"created": "2018-07-10T00:00:00.000Z",
"date_from": "2018-07-01",
"date_to": "2020-01-01",
"description": "Worked on distributed systems and observability",
"duration": "1 yr 6 mos",
"id": "exp_2",
"last_updated": "2020-01-10T00:00:00.000Z",
"location": "Seattle, WA",
"member_id": "mem_123",
"order_in_profile": 1,
"title": "Software Engineer",
"title_normalized": "Software Engineer",
"main_in_profile": false
}
],
"interests": [
{
"interest": "Artificial Intelligence",
"interest_id": "int_ai"
},
{
"interest": "Open Source",
"interest_id": "int_oss"
}
],
"languages": [
{
"language": "English",
"proficiency": "native"
},
{
"language": "French",
"proficiency": "professional"
}
],
"last_updated": "2024-10-31T12:00:00.000Z",
"lead_industry": "Computer Software",
"lead_linkedin_url": "https://www.linkedin.com/in/john-doe/",
"lead_logo_url": "https://example.com/john.png",
"linkedin_short": "john-doe",
"location": "San Francisco Bay Area",
"skills": [
{
"skill": "Machine Learning",
"skill_id": "sk_ml"
},
{
"skill": "Python",
"skill_id": "sk_py"
},
{
"skill": "MLOps",
"skill_id": "sk_mlops"
}
],
"summary": "Engineer focused on building ML systems that ship to production.",
"title": "Senior Machine Learning Engineer",
"lead_quality_score": 87,
"seniority": "senior",
"department": "engineering",
"connections_count_bucket": "500+",
"years_of_exp_bucket": "6-10 years",
"current_exp_company_name": "TechCorp Inc.",
"geopoint": [
37.7749,
-122.4194
],
"_score": 0.98123,
"_id": "people_abc123"
},
"version": {
"since": 20241031,
"type": "date"
},
"properties": [
"lead_id",
"canonical_shorthand_name",
"connections_count",
"country",
"full_name",
"education",
"experience_count",
"experiences",
"interests",
"languages",
"last_updated",
"lead_industry",
"lead_linkedin_url",
"lead_logo_url",
"linkedin_short",
"location",
"skills",
"summary",
"title",
"lead_quality_score",
"seniority",
"department",
"connections_count_bucket",
"years_of_exp_bucket",
"current_exp_company_name",
"geopoint",
"_score",
"_id"
]
}Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Was this page helpful?