Developers · Employees API · 4 min read
Sync employees with the Northwind API
Pull your people directory into payroll, IT or any internal tool with one authenticated request.
List employees
Send a GET request to /v2/employees with your key in the Authorization header. Filter by team or status to keep responses small.
list-employees.shShell
curl https://api.northwind.io/v2/employees \
-H "Authorization: Bearer $NORTHWIND_API_KEY" \
-G -d "team=Engineering" -d "status=active"
Warning: Keep keys out of code
Store the key in an environment variable such as NORTHWIND_API_KEY, never in your repository.
The response
Results come 50 at a time. Pass next_cursor as cursor to get the next page; it is null on the last one. The highlighted employee_id is the key every other endpoint uses.
response.jsonJSON
{
"data": [
{
"employee_id": "emp_3RkQ81",
"name": "Ahmed Raza",
"team": "Engineering",
"start_date": "2023-04-03"
}
],
"next_cursor": "cur_9fJ2"
}