> ## 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 worker addresses

> List worker addresses.

### Parameters

<ParamField query="worker" type="string">
  Filter by worker ID.
</ParamField>

<ParamField query="purpose" type="string">
  Filter by purpose. One of `residential`, `business`, or `shipping`.
</ParamField>

<ParamField query="current" type="boolean">
  Filter by whether the address is current.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of addresses to return.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

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

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

### Returns

Returns a list object containing [Worker address objects](/reference/worker-addresses/object).