Searchers are used to lookup and scan objects in the ledger. A searcher takes a client, query string and optional pagination hash. For example, to search customer’s by name:

searcher =
  client: client # assuming this is defined,
  query: 'test'

result = # returns a LedgerSync::SearchResult

if result.success?
  resources = result.resources
  # Do something with found resources
else # result.failure?
  raise result.error

# Different ledgers may use different pagination strategies.  In order
# to get the next and previous set of results, you can use the following:
next_searcher = searcher.next_searcher
previous_searcher = searcher.previous_searcher

Related articles: