---
title: Pagination
description: Paginate through GraphQL Analytics API results.
image: https://developers.cloudflare.com/core-services-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/analytics/llms.txt  
> Use this file to discover all available pages before exploring further.

[Skip to content](#%5Ftop) 

# Pagination

Pagination – breaking up your query results into smaller parts – can be done using `limit`, `orderBy`, and filtering parameters. The GraphQL Analytics API does not support cursors for pagination.

* `limit` (integer) defines how many records to return.
* `orderBy` (string) defines the sort order for the data.

## Query pages without cursors

Our examples assume that the `date` and `clientCountryName` relationships are unique.

### Get the first _n_ results of a query

To limit results, add the `limit` parameter as an integer. For example, query the first two records:

JavaScript

```

firewallEventsAdaptive (limit: 2, orderBy: [datetime_ASC, clientCountryName_ASC]) {

    datetime

    clientCountryName

}


```

Note

Specifying a sort order by date returns less specific results than specifying a sort order by date and country.

**Response**

JavaScript

```

{

  "firewallEventsAdaptive" : [

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "UM"

    },

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "US"

    }

  ]

}


```

### Query for the next page using filters

To get the next _n_ results, specify a filter to exclude the last result from the previous query. Taking the previous example, you can do this by appending the greater-than operator (`_gt`) to the `clientCountryName` field and the greater-or-equal operator (`_geq`) to the `datetime` field. This is where being specific about sort order comes into play. You are less likely to miss results using a more granular sort order.

JavaScript

```

firewallEventsAdaptive (limit: 2, orderBy: [datetime_ASC, clientCountryName_ASC], filter: {datetime_geq: "2018-11-12T00:00:00Z", clientCountryName_gt: "US"}) {

    datetime

    clientCountryName

}


```

**Response**

JavaScript

```

{

  "firewallEventsAdaptive" : [

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "UY"

    },

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "UZ"

    }

  ]

}


```

### Query the previous page

To get the previous _n_ results, reverse the filters and sort order.

JavaScript

```

firewallEventsAdaptive (limit: 2, orderBy: [datetime_DESC, clientCountryName_DESC, filter: {datetime_leq: "2018-11-12T00:00:00Z", clientCountryName_lt: "UY"}]) {

  datetime

  clientCountryName

}


```

**Response**

JavaScript

```

{

  "firewallEventsAdaptive" : [

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "US"

    },

    {

      "datetime": "2018-11-12T00:00:00Z",

      "clientCountryName": "UM"

    }

  ]

}


```

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/analytics/","name":"Analytics"}},{"@type":"ListItem","position":3,"item":{"@id":"/analytics/graphql-api/","name":"GraphQL Analytics API"}},{"@type":"ListItem","position":4,"item":{"@id":"/analytics/graphql-api/features/","name":"Features"}},{"@type":"ListItem","position":5,"item":{"@id":"/analytics/graphql-api/features/pagination/","name":"Pagination"}}]}
```