---
sourceDocument: Australia API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/api-reference

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Configure return results data

# Configure return results data {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Configure Return Results Data

The Mobile SDK allows you to interact with a ServiceNow instance through REST endpoints, enabling you to customize the data returned.
Using the FetchConfiguration API, you can specify which records and fields to retrieve, as well as the number of records to return.
It is recommended to maintain consistent FetchConfiguration across CRUD operations for a model type to avoid JSON Decoding failures.
Show full answer Show less  

## Key Features

* **Configurable Record Selection:** Use the Filter object to define specific records based on criteria and sorting requirements. This is done via the sysparmquery parameter in the REST API.
* **Flexible Filtering Options:**
  * Filter by criteria: Allows filtering with conditions that can be combined using OR logic.
  * Filter by keywords: Enables filtering using keywords and conditions that can be combined with AND or OR logic.
* **Field Configuration:** The FieldReadConfiguration object allows you to set which fields are included in the return results, along with their format, such as display values or actual values.

## Key Outcomes

By configuring return results effectively, you can streamline data retrieval processes, ensuring that only relevant information is fetched. This leads to enhanced performance and usability when interacting with ServiceNow data through the Mobile SDK.  
Within the Mobile SDK, when interacting with data from a ServiceNow instance through a REST endpoint, you can configure what data is
passed back in the return results.
You configure what data to pass back using the [FetchConfiguration](https://servicenow-prod.fluidtopics.net/zLs1e7wU7GdfxWZQB6uZOQ#FetchConfigAndroidAPI "The FetchConfiguration class provides the ability to define the configuration for fetching records from the associatedServiceNow table.") API. This interface enables you to configure:

* The specific records to return from a table.
* The specific fields to return from the records.
* The number of records to return.
{#mobsdk-and-config_results_returned__ul_f5t_p2c_3qb}  
Note:  
Generally you want to use the same FetchConfiguration for all of your CRUD operations for a certain model type as it determines which fields are returned. It should at least match the required properties on your model, or else JSON Decoding will fail.

## Configuring the specific records to return {#mobsdk-and-config_results_returned__specific_records}

The [Filter](https://servicenow-prod.fluidtopics.net/q4Np6yHM7IHZAyPYPtmzcw#FilteriOSStructure "The Filter structure provides the ability to configure filters that define the data to return in the return results of a REST endpoint query.") object within a FetchConfiguration call enables you to define the filter and sort requirements for the records that are fetched from a ServiceNow instance and passed back in the return results from a REST endpoint. This filter is passed in the sysparm_query parameter of the REST API endpoint. For additional information,
see [Table API](https://servicenow-prod.fluidtopics.net/p9XdJ6vCPwR04mC4QLJjGQ#c_TableAPI "The Table API provides endpoints that allow you to perform create, read, update, and delete (CRUD) operations on existing tables.").  
You can initialize the Filter object in two different ways depending on the desired filtering capabilities:

1. Filter by criteria. This filter enables you to filter based on one or more filter criteria that are OR'd together.  
   For example, a manager has an employee Abel Tuter who is on PTO. They want to know if there are active incidents that are not assigned to anyone or assigned to Abel Tuter so they can assign/reassign them. They also want to see in that same list, all of the incidents that have high or overdue escalation so that they can also address those. The following shows how to create the necessary filters to obtain this data:

       val activeIncidents = BooleanSimpleCondition.conditionIs("active", true)
       val assignedToEmpty = StringSimpleCondition.isEmpty("assigned_to")
       val assignedToAbel = StringSimpleCondition.conditionIs("assigned_to", "Abel Tuter")

       val assignedToAbelOrEmpty =
         CompoundCondition(
         ConditionUtils.CompoundOperator.OR,
         listOf(assignedToEmpty, assignedToAbel))

       val needToReassign = Criteria().addConditions(listOf(activeIncidents,  
         assignedToAbelOrEmpty))

       val highEscelations = StringSimpleCondition.conditionIs("escalation", "2")
       val overdueEscelations = StringSimpleCondition.conditionIs("escalation", "3")

       val highOrOverdueEscelations =
         CompoundCondition(ConditionUtils.CompoundOperator.OR,
           listOf(highEscelations, overdueEscelations))

       val needToHandleEscalation =
         Criteria().addCondition(highOrOverdueEscelations)

       val myPrioritiesForTodayFilter = Filter(listOf(needToReassign,
         needToHandleEscalation))

       // Get record using filter
       val response = runCatching {
         getNowTableService()?.records(
           "sn_customerservice_case",
           FetchConfiguration(myPrioritiesForTodayFilter, 10)
         )?.execute()
       }

   To
   use this type of filtering, use the [Filter(criteriaList: List\<Criteria\>, sortBy: List\<Sort\>? = null)](https://servicenow-prod.fluidtopics.net/8rR9uR86ZuScdd3pXWIeVg#Filter-Filter_criteria_A_A "Creates a filter based on one or more filter criteria that are OR'd together.")
   function.
2. Filter by keywords and conditions. This filter enables you to filter records based on specific keywords and conditions that can be AND'd or OR'd together.For example:

       val keywords = "iOS 13 | iOS 14"
       val conditionA = BooleanSimpleCondition.conditionIs(testField, true)
       val conditionB = BooleanSimpleCondition.conditionIs(testField2, false)
       val sortA = Sort(testField, ConditionUtils.SortOperator.ORDER_ASC)
       val filter = Filter(conditions = listOf(conditionA, conditionB), keywords = keywords, sortBy = listOf(sortA))
       assertEquals(filter.query().second, "${conditionA.makeConditionQuery()}^${conditionB.makeConditionQuery()}^123TEXTQUERY321=$keywords^EQ^${sortA.makeSortQuery()}")

   To
   use this type of filtering, use the [Filter - Filter(conditions: List\<Condition\>, keywords: String? = null, sortBy: List\<Sort\>? = null)](https://servicenow-prod.fluidtopics.net/8rR9uR86ZuScdd3pXWIeVg#Filter-Filter_cond_A_S_A "Creates a filter based on specific keywords and conditions that can be OR'd or AND'd together.") function.
{#mobsdk-and-config_results_returned__ul_agc_qgc_3qb}

## Configuring the specific fields to return {#mobsdk-and-config_results_returned__section_ldz_cth_3qb}

The [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/1kAIr4ugLqYxCwKRA3etPg#FieldReadConfigAndroidAPI "The FieldReadConfiguration class provides the ability to define what fields to return or not return in a response record.") object within the FetchConfiguration() method call allows you to configure what fields to pass back in the return results. In addition, you can configure the format/content of the returned fields as:

* display values
* actual values
* exclude reference links
{#mobsdk-and-config_results_returned__ul_ybh_ng3_3qb}