# `describeSoqlListViews()`

Retrieves the SOQL query and other information about a list view.

## Syntax

```java
connection.describeSoqlListViews(DescribeSoqlListViewsRequest request);
```

## Usage

Use the `describeSoqlListViews()` call to retrieve information about a list view, including the ID, the columns, and the SOQL query. This call is useful if you want to use the SOQL that drives an existing list view in your custom application. This call is available in API version 32.0 and later.

## Sample Code—Java

```java
public void example() throws Exception {
         DescribeSoqlListViewsRequest request = createDescribeSoqlListViewsRequest(listViewId, null);
         this.getClient().describeSoqlListViews(request);
      }
```

## Arguments

| Name      | Type                                                                                                                                   | Description                                                                                                |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `request` | [DescribeSoqlListViewsRequest](/docs/platform/api/guide/sforce-api-calls-describesoqllistviewsrequest.md#describesoqllistviewsrequest) | The fully qualified name or the ID of the list view and the object with which the list view is associated. |

## Response

A [`DescribeSoqlListViewResult`](/docs/platform/api/guide/sforce-api-calls-describesoqllistviewresult.md#describesoqllistviewresult) object that contains one or more [`DescribeSoqlListView`](/docs/platform/api/guide/sforce-api-calls-describesoqllistview.md#describesoqllistview) objects.

## Faults

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

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