Interface LookupRecordsRequest._FinalStage
- All Known Implementing Classes:
LookupRecordsRequest.Builder
- Enclosing class:
LookupRecordsRequest
-
Method Summary
Modifier and TypeMethodDescriptionadditionalProperties(Map<String, Object> additionalProperties) additionalProperty(String key, Object value) build()Inclusive lower bound of a range lookup (requiresto; non-sensitive fields only).includePayload(String includePayload) includePayload(Optional<String> includePayload) Set totrueto include each record's full payload, rehydrating any payloads stored externally (capped per page).Maximum number of records to return per page.order(LookupRecordsRequestOrder order) order(Optional<LookupRecordsRequestOrder> order) Sort direction by the field's value:asc(ascending, the default) ordesc(descending).Prefix to match (string, non-sensitive fields only).Inclusive lower bound on the lookup field's sort key, narrowing avaluematch to records at or after this point.Inclusive upper bound on the lookup field's sort key, narrowing avaluematch to records at or before this point.Pagination cursor.Inclusive upper bound of a range lookup (requiresfrom).Exact value to match.Exact values to match, for a lookup declared over several fields — one value per field, in the order the lookup declares them, given as a repeated parameter (?
-
Method Details
-
build
LookupRecordsRequest build() -
additionalProperty
-
additionalProperties
-
values
Exact values to match, for a lookup declared over several fields — one value per field, in the order the lookup declares them, given as a repeated parameter (
?field=status,area&values=open&values=billing). Mutually exclusive withvalue; a singlevaluesis identical tovalue.You may supply fewer values than the lookup declares, as long as they are a leading run of its fields; doing so returns the records grouped by the fields you left unspecified. Narrowing with
sortFrom/sortTothen requires a value for every field, because the ordering is only continuous within one fully specified combination. -
values
-
values
-
value
Exact value to match. Mutually exclusive with
from/to,prefixandvalues. Rejected for a sensitive field — usePOST /v1/records/lookupinstead so the value is not exposed in the URL. -
value
-
from
Inclusive lower bound of a range lookup (requires
to; non-sensitive fields only). Mutually exclusive withvalueandprefix. -
from
-
to
Inclusive upper bound of a range lookup (requires
from). -
to
-
prefix
Prefix to match (string, non-sensitive fields only). Mutually exclusive with
valueandfrom/to. -
prefix
-
sortFrom
Inclusive lower bound on the lookup field's sort key, narrowing a
valuematch to records at or after this point. Use withvalue; combine withsortToto bound both ends. Give the bound in the same form as the sorted field's own values — epoch milliseconds when the lookup sorts bycreatedAtorlastUpdated. Records with no value for the sorted field are never included in a bounded window. -
sortFrom
-
sortTo
Inclusive upper bound on the lookup field's sort key, narrowing a
valuematch to records at or before this point. Use withvalue; combine withsortFrom. -
sortTo
-
startFrom
Pagination cursor. Pass the
nextCursorreturned by the previous page to fetch the next page; omit it for the first page. The cursor is opaque — echo it back unchanged, and do not parse it or construct one. Keep every other query parameter identical while paging: a cursor is valid only for the exact query that returned it, and reusing one against a different query is rejected with a 400. -
startFrom
-
limit
Maximum number of records to return per page. Allowed range 1–100; defaults to 20.
-
limit
-
includePayload
Set to
trueto include each record's full payload, rehydrating any payloads stored externally (capped per page). Defaults tofalse, which returns only the indexed projection. -
includePayload
-
order
Sort direction by the field's value:
asc(ascending, the default) ordesc(descending). -
order
-