> ## 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 leave balances

> Returns leave balances in your Plane workspace.

### Parameters

<ParamField query="worker" type="string">
  Only return balances for this worker ID.
</ParamField>

<ParamField query="policy" type="string">
  Only return balances for this leave policy ID.
</ParamField>

<ParamField query="type" type="string">
  Only return balances for this leave type.
</ParamField>

<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="starting_after" type="string">
  Return results after this object ID.
</ParamField>

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

### Returns

Returns a dictionary with a `balances` property that contains an array of
[Leave Balance](/reference/leave-balances/object) objects.