Skip to main content
POST
/
accounts
/
headcount
Get company headcount by department
curl --request POST \
  --url https://app.prontohq.com/api/v2/accounts/headcount \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "company_linkedin_id": "1818",
  "departments": [
    "Engineering",
    "Sales",
    "Finance"
  ]
}
'
{
  "Engineering": {
    "3_months_evolution": {
      "base_headcount": 8611,
      "current_headcount": 8681,
      "headcount_gain": 70,
      "headcount_gain_percentage": 1
    },
    "6_months_evolution": {
      "base_headcount": 8412,
      "current_headcount": 8681,
      "headcount_gain": 269,
      "headcount_gain_percentage": 3
    },
    "12_months_evolution": {
      "base_headcount": 8153,
      "current_headcount": 8681,
      "headcount_gain": 528,
      "headcount_gain_percentage": 6
    }
  },
  "Finance": {
    "3_months_evolution": {
      "base_headcount": 2801,
      "current_headcount": 2830,
      "headcount_gain": 29,
      "headcount_gain_percentage": 1
    },
    "6_months_evolution": {
      "base_headcount": 2774,
      "current_headcount": 2830,
      "headcount_gain": 56,
      "headcount_gain_percentage": 2
    },
    "12_months_evolution": {
      "base_headcount": 2659,
      "current_headcount": 2830,
      "headcount_gain": 171,
      "headcount_gain_percentage": 6
    }
  },
  "Sales": {
    "3_months_evolution": {
      "base_headcount": 6130,
      "current_headcount": 6258,
      "headcount_gain": 128,
      "headcount_gain_percentage": 2
    },
    "6_months_evolution": {
      "base_headcount": 5914,
      "current_headcount": 6258,
      "headcount_gain": 344,
      "headcount_gain_percentage": 6
    },
    "12_months_evolution": {
      "base_headcount": 5549,
      "current_headcount": 6258,
      "headcount_gain": 709,
      "headcount_gain_percentage": 13
    }
  }
}

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json
​
company_linkedin_id
string
required

LinkedIn company identifier

Example:

"1818"

​
departments
enum<string>[]

List of departments to get headcount for. If not provided, returns data for all departments.

Available options:
Accounting,
Administrative,
Arts and Design,
Business Development,
Community and Social Services,
Consulting,
Customer Success and Support,
Education,
Engineering,
Entrepreneurship,
Finance,
Healthcare Services,
Human Resources,
Information Technology,
Legal,
Marketing,
Media and Communication,
Military and Protective Services,
Operations,
Product Management,
Program and Project Management,
Purchasing,
Quality Assurance,
Real Estate,
Research,
Sales
Example:
["Engineering", "Sales", "Finance"]

Response

Successfully retrieved headcount data

​
{key}
object