# Returning list of all Retire Pools

## Return a list of all retire pools.

<mark style="color:blue;">`GET`</mark> `/contracts/retire/pools`

Returns all retire pools.

#### Query Parameters

| Name       | Type   | Description                                                           |
| ---------- | ------ | --------------------------------------------------------------------- |
| tokens     | String | Tokens                                                                |
| contractId | String | Contract Identifier                                                   |
| pageSize   | number | The numbers of items to return                                        |
| pageIndex  | number | The number of pages to skip before starting to collect the result set |

{% tabs %}
{% tab title="200: OK Successful Operation" %}

```
headers:
            x-total-count:
              schema:
                type: integer
              description: Total items in the collection.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RetirePoolDTO'
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```
content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorDTO'
```

{% endtab %}
{% endtabs %}