---
title: "Filter employee ids down to billed standard contractors"
method: POST
path: "/api/v1/employees/billed-standard-contractors"
tags: ["Employees", "Public API"]
---

# Filter employee ids down to billed standard contractors

`POST /api/v1/employees/billed-standard-contractors`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/employees/billed-standard-contractors`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `employee`
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `employee:job`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/employees/billed-standard-contractors/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Request body

- object
  - `employeeIds` integer[], required
  - `effectiveDate` string, date: Date to judge contractor status. Defaults to today in the company timezone.

## Response `200`

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

- object
  - `employeeIds` integer[]

## Other responses

- `400`: employeeIds is missing or is not a list of ids, or effectiveDate is not YYYY-MM-DD.
- `401`: Unauthorized.
- `501`: CONTRACTOR_PRODUCT is off, so this endpoint is not available yet.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/employees/billed-standard-contractors/post.md)

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)