refresh-client/tech.yaxi.routex.refresh/RoutexRefreshClient/search

search

suspend fun search(ticket: Ticket, filters: List<SearchFilter>, ibanDetection: Boolean = false, limit: UInt? = null, details: List<ConnectionDetails> = emptyList()): List<ConnectionInfo>

Search for service connections (banks and other providers).

Returns connections that match every entry in filters.

Parameters

ibanDetection

When true, SearchFilter.Term values that look like an IBAN (e.g. NL58YAXI1234567890) also yield connections matching the IBAN's bank code, on top of the regular text matches.

limit

Maximum number of results to return. null (default) leaves the server-side cap in effect.

details

Extra per-connection details to populate (e.g. ConnectionDetails.BICS).

Samples

val results =
    client.search(
        ticket = ticket,
        filters = listOf(SearchFilter.Term("sparkasse")),
        limit = 10u,
        details = listOf(ConnectionDetails.BICS),
    )