Endpoint

GETPeople

GET /people — returns people information for a single person, matched on any one identifier.

Query parameters

Parameter	Type	Description
id	string	Firmable person identifier (e.g. fp000000067890)
ln_slug	string	LinkedIn slug (e.g. chathchw)
ln_url	string	Full LinkedIn profile URL
work_email	string	Work email of the person
personal_email	string	Personal email of the person

Example request

curl "https://api.firmable.com/people?ln_slug=chathchw" \
  -H "Authorization: Bearer <FIRMABLE_API_KEY>"

Responses

A success returns a People object: identity, professional info (position, current_company, department, seniority), contact details (emails with deliverability, phones with an is_dnd flag), social profiles, location, skills, education, keywords, and secondary_position.

200People object

{
  "id": "fp000000067890",
  "name": "John Doe",
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "M",
  "headline": "Unlimited C-Suite Partner",
  "description": "I am a finance manager at a bank",
  "position": "Chief Marketing Officer",
  "current_company": {
    "id": "f0000067890",
    "name": "Company Name",
    "size": "11 - 50",
    "website": "https://www.example.com",
    "industry": ["Finance", "Tech"],
    "linkedin": "person_slug",
    "main_phones": ["0450 600 0000"],
    "other_phones": ["0450 600 0000"],
    "mobile_phones": ["0450 600 0000"]
  },
  "time_in_current_role": "Jan '23 - Present",
  "month_joined": 2,
  "year_joined": 2002,
  "emails": {
    "personal": [{ "value": "email@gmail.com", "deliverability": "Deliverable" }],
    "work": [{ "value": "email@gmail.com", "deliverability": "Deliverable" }]
  },
  "phones": [{ "value": "0450 600 0000", "is_dnd": false }],
  "linkedin": "https://www.linkedin.com/in/person_slug",
  "social_media": {
    "linkedin": { "handle": 100, "connections": "username", "followers": 100, "stars": 100 },
    "github":   { "handle": 100, "connections": "username", "followers": 100, "stars": 100 },
    "twitter":  { "handle": 100, "connections": "username", "followers": 100, "stars": 100 },
    "facebook": { "handle": 100, "connections": "username", "followers": 100, "stars": 100 },
    "youtube":  { "handle": 100, "connections": "username", "followers": 100, "stars": 100 },
    "pintrest": { "handle": 100, "connections": "username", "followers": 100, "stars": 100 }
  },
  "location": ["Sydney", "Melbourne"],
  "department": "Marketing",
  "seniority": "C-Suite / Partner",
  "gender": "Female",
  "skills": ["Finance", "Tech"],
  "education": {
    "field": "Computer Science",
    "degree": "University of Sydney",
    "date_range": "University of Sydney",
    "school_name": "University of Sydney"
  },
  "keywords": ["Finance", "Tech"],
  "secondary_position": [
    {
      "company_id": "f000000120808",
      "company_name": "Firmable",
      "company_size": "1 - 100",
      "company_website": "https://firmable.com",
      "company_linkedin": "company-slug",
      "company_industry": "Financial Services",
      "cleaned_position": "Marketing Principal",
      "month_joined": 11,
      "year_joined": "2022",
      "time_in_current_role": "Nov '22 - Present",
      "seniority": "Other",
      "department": "Marketing"
    }
  ]
}

400Error

{
  "error": 123,
  "message": "<string>"
}

← Company Next: People Search →