Pagination

Most MARCO API endpoints that return large sets of data are paginated. This means that the API will only return a subset of the data at a time, and you need to make multiple requests to fetch all the data.

Parameters

The API supports pagination using two query parameters:

Query parameter	Description
page	Default value: 1 Minimum value: 1 Specifies the current page of results.
size	Default value: 20 Minimum value: 5 Maximum value: 100 Determines the number of records on each page.

Using pagination

To fetch paginated data from the MARCO API, include the pagination parameters in your API query. For example:

GET https://api-marco.finboot.com/v1/sample-endpoint?page=2&size=10

Identifying paginated endpoints

When an endpoint returns paginated data, the response will typically include metadata structured as follows:

{
    "contentType": "ActionPage",
    "pageElements": 200,
    "pageNumber": 1,
    "totalElements": 2,
    "totalPages": 1,
    "pageContent": [
        "..."
    ]
}

If you see a pageNumber field in the response, it indicates that the endpoint supports pagination.