> For the complete documentation index, see [llms.txt](https://docs.shipbubble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shipbubble.com/get-started/pagination.md).

# Pagination

Whenever you try to retrieve a list (e.g shipping labels list), the pagination property is added to their response by default

We include the following as query parameters to limit our queries. 

<mark style="color:blue;">`GET`</mark> `/example_list_url?Page=1&PerPage=1`

#### Query Parameters

| Name    | Type   | Description                                                                                                                                                            |
| ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PerPage | number | This is the maximum number of records that will be returned after the request. This can be modified by passing a new value into the query parameter. **Default is 50** |
| Page    | number | This is current `page` to be returned per request. **Default: 1**                                                                                                      |

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

```javascript
{
    "status": "success",
    "message": "Retrieved successfully",
    "data": {
        "results": [],
        "pagination": {
            "current": 1,
            "perPage": 1,
            "previous": 0,
            "next": 7,
            "total": 8
        }
    }
}
```

{% endtab %}
{% endtabs %}