PageResponse

public struct PageResponse<Element> : Decodable, Sendable where Element : Decodable, Element : Sendable

Generic paginated response wrapper for Horizon API list endpoints.

The Stellar Horizon API returns large result sets as pages to avoid overwhelming clients and servers. PageResponse provides the current page of results along with navigation links to access previous and next pages.

Pagination uses cursor-based navigation, where each record has a unique paging token. Results are ordered by the specified sort order (ascending or descending).

Example usage:

let sdk = StellarSDK()

// Get first page of transactions
let response = await sdk.transactions.getTransactions(
    limit: 20,
    order: .descending
)

switch response {
case .success(let page):
    // Process current page
    print("Fetched \(page.records.count) transactions")

    for transaction in page.records {
        print("Hash: \(transaction.hash)")
    }

    // Navigate to next page if available
    if page.hasNextPage() {
        let nextPage = await page.getNextPage()
        // Process next page...
    }

    // Or get cursor for later pagination
    if let nextLink = page.links.next?.href {
        // Save cursor from URL for later use
    }

case .failure(let error):
    print("Error: \(error)")
}

See also:

• Stellar developer docs
• PagingLinksResponse for navigation links