BAbamboohr
Employees
Public API

Filter employee ids down to billed standard contractors

Changed on

Returns the subset of employee ids who are billed standard contractors: Bamboo's seeded Contractor status, or the official Contractor employment type, at a company with the contractor product. Status is judged on effectiveDate, or on today in the company timezone when that field is omitted. Ids the caller cannot see are omitted. Returns an empty list when the company does not have the contractor tool.

OAuth Scopes: employee, employee:job

post/api/v1/employees/billed-standard-contractors

Request

Request body

employeeIdsinteger[] required
effectiveDatestring date

Date to judge contractor status. Defaults to today in the company timezone.

Example request

{
  "effectiveDate": "2026-09-30"
}

Response

Employee ids that are billed standard contractors and visible to the caller. Empty when the company does not have the contractor tool.

employeeIdsinteger[]

Example response

{
  "employeeIds": [
    2
  ]
}

Changes