# Filter methods The Ubidots API supports requests using [field filters](https://docs.ubidots.com/reference/field-filters), like this: ```bash GET https://industrial.api.ubidots.com/api/v2.0/devices/?label__startswith=temp ``` This library also provides a way to construct custom requests that take advantage of these filters. ## Filter methods
Filter methodDescriptionUsageArgumentsResponse
whereApplies a filter on a single property of the given entityUbidots.<entity>.where(<entity-property>).<filter>(<filter-value>).<get-method>(, [args])A valid property of the given entityDepends on the <getMethod> used.
addRawParamsApplies filters on multiple properties of the given entityUbidots.<entity>.addRawParams(<query-object>).<get-method>(, [args])

query-object: object An object containing queryparam-value pairs

{
  queryParam1: value1 
  ···    
  queryParamN: valueN
}
Depends on the <getMethod> used.
## Using `where` method The example GET request shown at the top of this page can be replicated using the library's `where` method, like this: ```javascript const tempDevices = await Ubidots.devices.where('label').startsWith('temp').get(); ``` **Here:** * ` = devices` * ` = 'label'` * ` = startsWith` * ` = 'temp'` * ` = get` ## Using `addRawParams` method The example GET request shown at the top of this page can be replicated using the library's `addRawParams` method, like this: ```javascript const filterParameters = { label__startswith: 'temp', }; const tempDevices = await Ubidots.devices.addRawParams(filterParameters).get(); ``` **Here:** * ` = devices` * ` = filterParameters` * ` = get` * ` = label__startswith` * ` = 'temp'` ## Accessing the filters [API filters](https://docs.ubidots.com/reference/field-filters) are written in snake-case. Take a look at some of the supported [object filters](https://docs.ubidots.com/reference/json) for example: * contains * contained\_by * has\_key In order to maintain the camel-case standard of JavaScript, the library's filters are written in camel-case, so the previous filters would look like this: * contains * containedBy * hasKey Below you'll find the full list filters, as defined in the API vs. how they look in the library. ### [ID](https://docs.ubidots.com/reference/id) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | exact ( = ) | `exact` | | in | `in` | ### [Boolean](https://docs.ubidots.com/reference/boolean) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | exact ( = ) | `is` | | isnull | `isNull` | ### [Number](https://docs.ubidots.com/reference/number) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | exact | `is` | | range | `range` | | gt ( > ) | `greaterThan` | | gte (`≥`) | `greaterThanEq` | | lt ( < ) | `lowerThan` | | lte (`≤`) | `lowerThanEq` | | isnull | `isNull` | ### [String](https://docs.ubidots.com/reference/string) | Filter in the API | Filter in the library | | :----------------------------: | :-------------------: | | exact ( = ) (case sensitive) | `exact` | | iexact (case sensitive) | `iexact` | | contains | `contains` | | icontains (case insensitive) | `iContains` | | startswith | `startsWith` | | istartswith (case insensitive) | `iStartsWith` | | endswith | `endsWith` | | iendswith (case insensitive) | `iEndsWith` | | in (case sensitive) | `in` | | isnull | `isNull` | ### [Array](https://docs.ubidots.com/reference/array) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | exact ( = ) | `exact` | | contains | `contains` | | contained\_by | `containedBy` | | overlap | `overlap` | | len | `len` | | isnull | `isNull` | ### [Object](https://docs.ubidots.com/reference/json) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | contains | `contains` | | contained\_by | `containedBy` | | has\_key | `hasKey` | | has\_any\_keys | `hasAnyKeys` | | has\_keys | `hasKeys` | | isnull | `isNull` | ### [Date](https://docs.ubidots.com/reference/date) | Filter in the API | Filter in the library | | :---------------: | :-------------------: | | exact ( = ) | `exact` | | date | `date` | | year | `year` | | quarter | `quarter` | | month | `month` | | week | `week` | | day | `day` | | hour | `hour` | | minute | `minute` | | second | `second` | | isnull | `isNull` |