# API Pagination

[View original](https://ittybit.cloud/api/pagination)

## Limit Param

You can fetch different pages of results by including a `limit` query parameter in your request.

`https://api.ittybit.cloud/files?limit=5`

The default limit is `20`.

The minimum limit is `1` and the maximum limit is `100`.

***

## Page Param

You can fetch different pages of results by including a `page` query parameter in your request.

`https://api.ittybit.cloud/files?page=2`

The default page is `1`.

<Callout type="warning">
  <Icon icon="warning" />

  If you set the page to a number that doesn't exist, you will receive an empty list.
</Callout>

***

## Query Params

You can combine the `limit` and `page` query params to fetch different pages of results.

`https://api.ittybit.cloud/files?limit=5&page=2`

***

## SDKs

The [ittybit SDKs](/sdks) accept pagination parameters in the request options.

<Tabs groupId="language" items={["typescript", "python", "ruby", "php", "go", "fetch" ]} persist>
  <Tab value="typescript">
    ```ts
    const files = await ittybit.files.list({
      limit: 5,
      page: 2
    });
    ```
  </Tab>

  <Tab value="python">
    ```python
    files = ittybit.files.list(
      limit=5,
      page=2
    )
    ```
  </Tab>

  <Tab value="ruby">
    ```ruby
    files = ittybit.files.list(
      limit: 5,
      page: 2
    )
    ```
  </Tab>

  <Tab value="php">
    ```php
    $files = $ittybit->files->list([
      'limit' => 5,
      'page' => 2
    ]);
    ```
  </Tab>

  <Tab value="go">
    ```go
    files, err := ittybit.Files.List(
        context.TODO(),
    	  &sdk.FilesListRequest{
            Limit: 5,
            Page: 2,
        }
    )
    ```
  </Tab>

  <Tab value="fetch">
    ```javascript
    const response = await fetch('https://api.ittybit.cloud/files?limit=5&page=2');
    const files = await response.json();
    ```
  </Tab>
</Tabs>

***

### Links Header

In responses which support pagination, the `Links` header will include URLs for navigating through pages of results. [^1]

```txt
Links:
  <https://api.ittybit.cloud/files?page=2>; rel="self",
  <https://api.ittybit.cloud/files?page=1>; rel="first",
  <https://api.ittybit.cloud/files?page=1>; rel="prev",
  <https://api.ittybit.cloud/files?page=3>; rel="next",
  <https://api.ittybit.cloud/files?page=5>; rel="last"
```

The `rel` attribute will indicate the relationship of the linked resource to the current resource:

* **self** *string*

  The URL to refetch the current page

* **first** *string*

  The URL to fetch the first page

* **next** *string* | *null*

  The URL to fetch the next page

* **prev** *string* | *null*

  The URL to fetch the previous page

* **last** *string*

  The URL to fetch the last page

***

[^1]: We have consciously chosen not to include a complete hypermedia implementation. The limited extra functionality is not worth increased response size for every request. Take away our RESTful badge if you want, we don't care. 😊