# `describeSearchScopeOrder()`

Retrieves an ordered list of the objects in a user's default global search scope.

## Syntax

```java
DescribeSearchScopeOrderResult[] describeSearchScopeOrderResults = connection.describeSearchScopeOrder();
```

## Usage

Use [`describeSearchScopeOrder()`](/docs/platform/api/guide/sforce-api-calls-describesearchscopeorder.md) to retrieve an ordered list of objects in the default global search scope of a logged-in user. Global search tracks the objects the user interacts with and how often and arranges the search results accordingly. Objects used most frequently appear at the top of the list. The returned list reflects the object order in the user’s default search scope, including any pinned objects on the user’s search results page. This call is useful if you want to implement a custom search results page using the optimized global search scope.

:::note
You must enable Chatter to enable global search.
:::

## Sample Code—Java

This sample shows how to retrieve the global search scope for a user and then iteratively display the name of each object in the scope.

```class
public void describeSearchScopeOrderSample() { 
  try { 
    //Get the order of objects in search smart scope for the logged-in user
    DescribeSearchScopeOrderResult[] describeSearchScopeOrderResults = 
        connection.describeSearchScopeOrder();
    //Iterate through the results and display the name of each object
    for (int i = 0; i < describeSearchScopeOrderResults.length; i++) {
      System.out.println(describeSearchScopeOrderResults[i].getName());
    }
  } 
  catch(ConnectionException ce) {
    ce.printStackTrace();
  }
}

```

## Arguments

None.

## Response

An array of [DescribeSearchScopeOrderResult](/docs/platform/api/guide/sforce-api-calls-describesearchscopeorder-describesearchscopeorderresult.md) objects

## Fault

[`UnexpectedErrorFault`](/docs/platform/api/guide/sforce-api-calls-concepts-core-data-objects.md)

**See Also**

- [API Call Basics](/docs/platform/api/guide/calls.md)