Skip to main content

​
Pagination

Both TypeScript and Python SDKs handle pagination automatically. The SDKs return paginated responses that you can iterate through to access all data.

​
Basic Pagination

import { Fathom } from 'fathom-typescript';

const fathom = new Fathom({
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

const result = await fathom.listMeetings({});

for await (const page of result) {
  console.log(page);
}

from fathom_python import Fathom, models

with Fathom(
    security=models.Security(
        api_key_auth="YOUR_API_KEY",
    ),
) as fathom:
    res = fathom.list_meetings()

    while res is not None:
        print(res)
        res = res.next()

​
Processing All Data

Here’s how to collect all data from paginated responses: 
import { Fathom } from 'fathom-typescript';

async function getAllMeetings() {
  const fathom = new Fathom({
    security: {
      apiKeyAuth: "YOUR_API_KEY"
    }
  });

  const result = await fathom.listMeetings({});
  const allMeetings: any[] = [];
  
  for await (const page of result) {
    if (page.items) {
      allMeetings.push(...page.items);
    }
  }
  
  console.log(`Total meetings: ${allMeetings.length}`);
  return allMeetings;
}

from fathom_python import Fathom, models

def get_all_meetings():
    with Fathom(
        security=models.Security(
            api_key_auth="YOUR_API_KEY",
        ),
    ) as fathom:
        res = fathom.list_meetings()
        all_meetings = []
        
        while res is not None:
            all_meetings.extend(res.result.items)
            res = res.next()
        
        print(f"Total meetings: {len(all_meetings)}")
        return all_meetings

​
Pagination Best Practices

  1. Use async iteration (TypeScript): The for await...of syntax is the recommended way to handle pagination
  2. Use while loops (Python): The while res is not None pattern is the standard approach
  3. Process incrementally: For large datasets, consider processing each page as it comes rather than collecting all data in memory
  4. Handle errors: Wrap pagination in try-catch blocks for robust error handling (see Error Handling)
  5. Respect rate limits: The SDK handles rate limiting automatically, but be mindful of API usage