List employees

Employees: Query employee records synced from your HRIS. Employees are read-only via the API.

Endpoint4 params

Parameters

Name	Type	Required	Description
`status`	string	no	Filter by employment status.
`search`	string	no	Search across name, email, and job title
`limit`	integer	no	Items per page, 1-100 (default: 25)
`cursor`	string	no	Pagination cursor from a previous response

javascript

const response = await fetch(`https://api.quipteams.com/api/v1/employees?limit=10`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
});

const { data } = await response.json();
console.log(data);

Response

json

{
  "data": [
    {
      "id": "emp-uuid-001",
      "remote_id": "HRIS-12345",
      "first_name": "Jane",
      "last_name": "Smith",
      "display_name": "Jane Smith",
      "email": "jane@acme.com",
      "employment_status": "ACTIVE",
      "start_date": "2024-03-15",
      "termination_date": null,
      "job_title": "Software Engineer",
      "department": "Engineering",
      "work_location": "New York",
      "company_name": "Acme Corp"
    }
  ],
  "meta": {
    "has_more": true,
    "next_cursor": "eyJpZCI6ImVtcC0wMDEiLCJjcmVhdGVkX2F0IjoiMjAyNi0wMy0xNSJ9",
    "total": 156
  }
}