Dimension Service API  2.0.0
api index

SearchRequest Object

since: 0.32
This object allows callers to construct advanced search queries.

For example, when results are required to be sorted in either ascending or descending order, the optional SearchSort.sort field can be used to indicate the type of sorting that should be used.

Fields

query
0.32required
The query to use for the search.

This field is required.

options
0.32optional
Additional options that affect the search. Use this options field to configure settings such as the page size or page number from a paginated result.

This field is optional.

sort
0.32optional
Sorting options such as field to sort by, order (e.g. ascending, descending), and attribute type (when sorting by attributes).

This field is optional.

Related API Resources

Example - Search request with 'US-TX' as the search term

{
  "query": {
    "query": "US-TX"
  },
  "options": {
    "pageSize": 50,
    "pageNumber" 1
  },
  "sort": {
    "field": "name",
    "order": "asc"
  }
}

Example - Search request with 'Augustus' as the search term and 'FOUNDER' as the attribute.

{
  "query": {
    "query": "Augustus",
    "attribute": "FOUNDER"
  },
  "options": {
    "pageSize": 50,
    "pageNumber" 1
  },
  "sort": {
    "field": "name",
    "order": "asc"
  }
}