> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List workers

> Returns workers in your Plane workspace.

### Parameters

<ParamField query="limit" type="number">
  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
  default is 10.
</ParamField>

<ParamField query="cursor" type="string">
  A value from a previous response that lets you fetch the next page.
</ParamField>

<ParamField query="query" type="string">
  Search workers by display name.
</ParamField>

<ParamField query="type" type="string">
  Only return workers with this type, one of `employee`, `contractor`, or `vendor`.
</ParamField>

<ParamField query="country" type="string">
  Only return workers whose current employment location has this country code.
</ParamField>

<ParamField query="starting_after" type="string">
  Return results after this worker ID.
</ParamField>

<ParamField query="ending_before" type="string">
  Return results before this worker ID.
</ParamField>

<ParamField query="updated_after" type="string">
  Only return workers updated after this timestamp. Use an ISO 8601 datetime such as
  `2026-03-27T00:00:00Z`.
</ParamField>

### Returns

Only one of `cursor`, `starting_after`, or `ending_before` may be provided.

Returns a dictionary with a `workers` property that contains an array of
[Worker](/reference/workers/object) objects. When another page is available, the
response also includes a `cursor` value.

<ResponseExample>
  ```json Response theme={null}
  {
    "workers": [
      {
        "id": "wr_yLSx6",
        "type": "employee",
        "number": null,
        "title": "Corporate Controller",
        "name": "Grace Thompson",
        "email": "grace.thompson@mail.example.com",
        "dob": null,
        "compensation": {
          "amount": "37.0",
          "unit": "hour",
          "currency": "USD",
          "frequency": "monthly",
          "stock": null,
          "other": null
        },
        "classification": {
          "type": "",
          "status": "",
          "term": "",
          "overtime": null,
          "starts": "2026-03-27",
          "ends": null
        },
        "role": {
          "title": "Corporate Controller",
          "responsibilities": "Financial reporting, internal controls, audit management, compliance",
          "level": "Manager"
        },
        "reporting": {
          "department": null,
          "manager": {
            "name": "",
            "email": "priya@airfoil.example.com"
          },
          "starts": null,
          "ends": null
        },
        "employment": {
          "id": "wre_yLSx6",
          "current": true,
          "status": "active",
          "starts": "2025-03-27",
          "ends": null,
          "primary": true,
          "compensation": {
            "amount": "37.0",
            "unit": "hour",
            "currency": "USD",
            "frequency": "monthly",
            "stock": null,
            "other": null
          },
          "location": {
            "address": {
              "country": "US",
              "city": "San Francisco",
              "line1": "123 Market Street",
              "line2": "Suite 500",
              "postal_code": "94103",
              "state": "CA"
            }
          },
          "classification": {
            "type": "",
            "status": "",
            "term": "",
            "overtime": null,
            "starts": "2026-03-27",
            "ends": null
          },
          "role": {
            "title": "Corporate Controller",
            "responsibilities": "Financial reporting, internal controls, audit management, compliance",
            "level": "Manager"
          },
          "reporting": {
            "department": null,
            "manager": {
              "name": "",
              "email": "priya@airfoil.example.com"
            },
            "starts": null,
            "ends": null
          }
        },
        "accounts": []
      }
    ],
    "cursor": "WyIyMDI2LTAzLTI3VDIxOjE2OjQwLjM3MTA0Mi0wNzowMCIsIndyX3lMU3g2Il0"
  }
  ```
</ResponseExample>