Skip to main content

​
Cursor-Based Pagination

List endpoints use cursor-based pagination for consistent results.

​
Parameters

ParameterTypeDescription
limitintegerResults per page (1-100, default 20)
starting_afterstringCursor for next page
ending_beforestringCursor for previous page

​
Example

# First page
GET /v1/identity/verifications?limit=20

# Next page
GET /v1/identity/verifications?limit=20&starting_after=ver_abc123

​
Response

{
  "object": "list",
  "data": [
    { "id": "ver_xyz789", ... },
    { "id": "ver_abc123", ... }
  ],
  "has_more": true
}

​
Iterating All Results

async function* getAllVerifications() {
  let cursor = null;
  
  while (true) {
    const page = await txcloud.identity.verifications.list({
      limit: 100,
      starting_after: cursor
    });
    
    for (const item of page.data) {
      yield item;
    }
    
    if (!page.has_more) break;
    cursor = page.data[page.data.length - 1].id;
  }
}