---
title: "Get Contractor Employees"
method: GET
path: "/contractors/{id}/employees"
tags: ["Contractors", "Contractors", "Contractors"]
---

# Get Contractor Employees

`GET /contractors/{id}/employees`

Returns a paginated list of employees for a specific contractor.

## Path parameters

- `id` string, required — Filter by the specified contractor ID.

## Query parameters

- `cursor` string, nullable — Cursor for pagination
- `size` integer

## Response `200`

A list of employees associated with the contractor.

- PaginatedEmployeesResponse — Schema for paginated employees list response.
  - `items` Employees[], required — The list of items returned in the response following given criteria.
    - `id` string, required — Unique identifier for the person.
    - `contractor_id` string, required — The contractor identifier this employee belongs to.
    - `name` string, nullable — Full name of the employee.
    - `street_no` string, nullable — Street number of employee's address.
    - `street` string, nullable — Street name of employee's address.
    - `city` string, nullable — City of employee's address.
    - `zip_code` string, nullable — ZIP code of employee's address.
    - `zip_code_ext` string, nullable — ZIP code extension.
    - `state` string, nullable — State of employee's address.
    - `phone` string, nullable — Employee's phone number.
    - `email` string, nullable — Employee's personal email.
    - `business_email` string, nullable — Employee's business email.
    - `linkedin_url` string, nullable — Employee's LinkedIn profile URL.
    - `homeowner` string, nullable — Homeowner status.
    - `gender` string, nullable — Gender of the employee.
    - `age_range` string, nullable — Age range of the employee.
    - `is_married` boolean, nullable — Marital status of the employee.
    - `has_children` boolean, nullable — Whether the employee has children.
    - `income_range` string, nullable — Income range of the employee.
    - `net_worth` string, nullable — Net worth range of the employee.
    - `job_title` string, nullable — Current job title of the employee.
    - `seniority_level` string, nullable — Seniority level in the organization.
    - `department` string, nullable — Department the employee works in.
  - `size` integer, required — The number of items returned in the response.
  - `next_cursor` string, nullable, required — The cursor for retrieving the next page of results.
  - `total_count` TotalCount — Capped result count with Elasticsearch-style {value, relation} shape. When the exact count is known and within the cap, relation is "eq" and value is that exact count. When the count exceeds the cap, relation is "gte" and value is the cap the count was probed against, meaning "the actual count is at least value". The cap is COUNT_CAP for every wire-facing endpoint; internal guard paths probe against their own cap, so value carries whatever cap produced it.
    - `value` integer, required — The count value; capped at the probe's cap (10,000 on the wire).
    - `relation` 'eq' | 'gte', required — "eq" means value is the exact count. "gte" means the actual count is at least value (the cap).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/shovels/apis/the-shovels-api-v2.md) · [All operations](https://skmtc.net/shovels/apis/the-shovels-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shovels/the-shovels-api-v2/revisions/64df4c8074f5/schema)