Get People Schema

Retrieves the schema definition for people in the people database.

GET /schema/people

Get People Schema

cURL

curl --request GET \
  --url https://api.lemlist.com/api/schema/people \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://api.lemlist.com/api/schema/people"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/schema/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/schema/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/schema/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

200

{
  "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"
  ]
}

"Bad team"

"The authentication you supplied is incorrect"

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Response

200

application/json

Success

schema · object · required

A person record from lemlist's People database.

Show child attributes

version · object · required

Show child attributes

properties · string[]