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

The response is of type object.