Pagination

Inttegro exposes paginated list endpoints for every high-volume resource (orders, balance transactions, payouts, and more). Each resource ships a /page endpoint that accepts a page_number and page_size, then returns a page object containing the records for that slice and metadata you can use to request additional pages.

Pagination is 1-based—requesting page_number: 1 gives you the newest data, and subsequent page numbers step backwards in time. You can request up to 256 items per page, though smaller window sizes (25–100) often make it easier to re-request failed pages and keep dashboards responsive. Every response echoes the parameters you sent so you always know which window you are looking at.

Request parameters

Name
page_number
Type
integer
Description
1-based index for the page you want. Always start with 1 and increment until the response contains fewer records than page_size, which indicates you've reached the end.
Name
page_size
Type
integer
Description
Number of objects to include per page (1–256). The default is 25. Choose a value that balances payload size with the number of requests your integration can comfortably make.

Example request

In this example we request the first page of recent orders. The response returns two orders along with number and size so we can continue paging through historic activity. Subsequent requests should increment the request's page_number by one until the response includes fewer objects than requested.

Fetch orders page

POST/orders/page

curl https://api.inttegro.com/orders/page \
  -H "Authorization: Bearer $INTTEGRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page_number": 1,
    "page_size": 2
  }'

SDK versionv8.2.0

import * as Inttegro from '@inttegro/inttegro-sdk'

const inttegro = new Inttegro.InttegroClient({
  apiKey: process.env.INTTEGRO_API_KEY!,
})
const result = await inttegro.orders.page({
  pageNumber: 1,
  pageSize: 2,
})

SDK versionv4.4.0

package main

import (
  "context"
  "log"
  "os"

  inttegro "github.com/zebodotdev/inttegro-sdk-go/v4"
)

func main() {
  ctx := context.Background()
  client := inttegro.NewClient(os.Getenv("INTTEGRO_API_KEY"))

  params := inttegro.OrderPageParams{
    PageNumber: 1,
    PageSize: 2,
  }
  result, err := client.Orders.Page(ctx, params)
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}

SDK versionv6.2.0

import os
import inttegro

client = inttegro.InttegroClient(api_key=os.environ["INTTEGRO_API_KEY"])
result = client.orders.page(inttegro.orders.PageRequest(
  page_number=1,
  page_size=2,
))

SDK versionv5.3.0

<?php

use Inttegro\Client;

$client = new Client($_ENV['INTTEGRO_API_KEY']);
$result = $client->orders->page([
  'page_number' => 1,
  'page_size' => 2,
]);

SDK versionv4.3.0

require "inttegro"

client = Inttegro::Client.new(api_key: ENV.fetch("INTTEGRO_API_KEY"))
result = client.orders.page(
  page_number: 1,
  page_size: 2
)

SDK versionv5.2.0

import com.inttegro.Client;
import com.inttegro.orders.OrderPageParams;

public class Example {
  public static void main(String[] args) throws Exception {
    var client = new Client(System.getenv("INTTEGRO_API_KEY"));
    var params = OrderPageParams.builder()
      .pageNumber(1)
      .pageSize(2)
      .build();
    var result = client.orders().page(params);
  }
}

SDK versionv6.2.0

using Inttegro;

using var inttegro = new InttegroClient(
    Environment.GetEnvironmentVariable("INTTEGRO_API_KEY")!
);
var result = await inttegro.Orders.PageAsync(new {
  page_number = 1,
  page_size = 2,
});

Response

Object
JSON

SDK versionv8.2.0

PageResponse {
  page: { … },
}

SDK versionv8.2.0

{
  "page": {
    "number": 1,
    "size": 2,
    "orders": [ … ]
  }
}