GET
/
people
curl --request GET \
  --url https://api.firmable.com/people \
  --header 'Authorization: Bearer <token>'
{
  "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"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
id
string

The unique identifier for a person in the Firmable system. (example: fp000000067890)

​
ln_slug
string

The LinkedIn slug of the person. (example: chathchw)

​
ln_url
string

The full LinkedIn URL of the person (example: https://www.linkedin.com/in/chathchw/)

​
work_email
string

Work email of the person (example: ******@firmable.com)

​
personal_email
string

Personal email of the person (example: ******@gmail.com)

Response

200
application/json
People response
​
id
string

The Firmable ID of the person..

Example:

"fp000000067890"

​
name
string

The full name of the person.

Example:

"John Doe"

​
first_name
string

The first name of the person.

Example:

"John"

​
last_name
string

The last name of the person.

Example:

"Doe"

​
middle_name
string | null

The person's middle name (if available).

Example:

"M"

​
headline
string

A brief professional headline.

Example:

"Unlimited C-Suite Partner"

​
description
string | null

A detailed description of the person.

Example:

"I am a finance manager at a bank"

​
position
string | null

The person's current job position.

Example:

"Chief Marketing Officer"

​
current_company
object

Details about the person's current company.

​
time_in_current_role
string

Duration in the current role.

Example:

"Jan '23 - Present"

​
month_joined
number

The month when the person joined their current role.

Example:

2

​
year_joined
integer | null

The year when the person joined their current role.

Example:

2002

​
emails
object
​
phones
object[]

List of phone numbers with additional details.

​
linkedin
string

LinkedIn profile handle.

Example:

"https://www.linkedin.com/in/person_slug"

​
social_media
object

Social media profiles and statistics.

​
location
string[]

The person's location information.

Example:
["Sydney", "Melbourne"]
​
department
string

The person's department information.

Example:

"Marketing"

​
seniority
string

Information about the person's seniority level.

Example:

"C-Suite / Partner"

​
gender
string

Information about the person's gender.

Example:

"Female"

​
skills
string[] | null

List of professional skills.

Example:
["Finance", "Tech"]
​
education
object

List of educational qualifications.

​
keywords
string[] | null

Keywords associated with the person (if available).

Example:
["Finance", "Tech"]
​
secondary_position
object[] | null

Information about secondary positions.