> ## 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 positions

> List workforce positions.

### Parameters

<ParamField query="plan" type="string">
  Filter positions by workforce plan.
</ParamField>

<ParamField query="status" type="string">
  Filter positions by status.
</ParamField>

<ParamField query="limit" type="integer">
  Number of positions to return.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

### Returns

Returns a list of [Position objects](/reference/positions/object).
