In the previous tutorial, we discussed how you can set your desired timezone. Before we dive into the extra details of our API, we need to discuss one of the fundamentals of our API: pagination.​

“How is it possible that I cannot find all the data I requested?”

Responses sometimes return more than 1000 results. With that much data, requests can become slow and hard to work with. That’s why these endpoints use something called pagination. Instead of returning all 1000+ results, you'll get a hundred results per page.

Create your request

Let's request all the fixtures between two dates. We can do this by using our get fixtures by date range endpoint. In the meta description of the response, you will see information about your subscription, the number of API calls and more. Please refer to our meta description page for more info.

Also, you can see information about the results of the response. In the second tab, you can see that the response returned 13454 results, but the API only shows a hundred results per page. With pagination, it results in 135 pages.

https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?api_token={API_TOKEN}

    "pagination": {
            "total": 13454,
            "count": 100,
            "per_page": 100,
            "current_page": 1,
            "total_pages": 135,
            "links": {
                "next": "https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?page=2"
            }
        }
    }

‘So, how do I get to the second page then?’

Excellent question. Going to the second page is easy! Simply add ‘&page=2’ to your request. In the second tab you will see that the meta description changes accordingly.

https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?api_token={API_TOKEN}&page=2

    "pagination": {
            "total": 13454,
            "count": 100,
            "per_page": 100,
            "current_page": 2,
            "total_pages": 135,
            "links": {
                "next": "https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?page=3"
            }
        }
    }

Request more or fewer results per page

Do you want the API to return more or fewer results per page? That’s also possible! You can determine the number of results per page (range 10-150) by adding ‘&per_page= {number}’ to your request. For example, if you want 110 results per page:

https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?api_token={API_TOKEN}&per_page=110

    "pagination": {
            "total": 13454,
            "count": 110,
            "per_page": 110,
            "current_page": 2,
            "total_pages": 135,
            "links": {
                "next": "https://soccer.sportmonks.com/api/v2.0/fixtures/between/2019-11-10/2019-12-12?page=3"
            }
        }
    }

Just like before, the meta description change accordingly.

For an overview of which endpoints support pagination, please refer to our API Reference Guide.​

Now that you know all about pagination, we can explore our API’s endless possibilities with the next chapter: enriching your response.