---
title: "List Employees"
method: GET
path: "/company_connections/{company_connection_id}/census"
tags: ["Company Connect"]
---

# List Employees

`GET /company_connections/{company_connection_id}/census`

List all employee census data reported by the payroll platform. This is a paginated endpoint; see how Pinwheel implements pagination <a href='https://docs.pinwheelapi.com/docs/pagination-1' target='_blank'>here</a>.

## Path parameters

- `company_connection_id` string, uuid, required — UUID of the Company Connection.

## Query parameters

- `cursor` string — Cursor for the page you want to retrieve.
- `limit` integer — The maximum number of results to return.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Response `200`

OK

- object
  - `meta` PaginationMeta, required
    - `count` integer — Number of objects returned.
    - `next_cursor` string — Pointer to the next page of results.
  - `data` CompanyIdentityObjResponse[], required
    - `created_at` string, date-time, required — ISO 8601 timestamp of created time.
    - `employee_external_id` string, required — Employee ID as reported by their employer.
    - `date_of_birth` string, date — The date the employee was born.
    - `emails` string[] — The emails associated with the employee.
    - `first_name` string, required — The first name of the employee.
    - `middle_name` string, required — The middle name of the employee.
    - `last_name` string, required — The last name of the employee.
    - `last_four_ssn` string — The last four digits of the employee's social security number (SSN).
    - `full_name` string, required — The full name of the employee.
    - `address` AddressGetResponseItem
      - `raw` string, required — The raw address.
      - `line1` string — The first line of the address.
      - `line2` string — The second line of the address.
      - `city` string — The city of the address.
      - `state` string — The state of the address.
      - `postal_code` string — The postal code of the address.
      - `country` 'US' — The country of the address.
    - `phone_numbers` PhoneNumberGetResponseItem[] — The phone numbers of the employee.
      - `value` string, required — The E.164 formatted phone number.
      - `type` 'home' | 'work' | 'mobile' — home, mobile, work, etc.

---

[API](https://skmtc.net/getpinwheel/apis/pinwheel.md) · [All operations](https://skmtc.net/getpinwheel/apis/pinwheel/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpinwheel/pinwheel/revisions/8ef86dd4902e/schema)