---
type: api
title: Get search applications
description: Get information about search applications.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/operation/operation-search-application-list
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/operation/operation-search-application-list
products:
  - Elasticsearch
---

# Get search applications

Availability: 8.8+

## Paths

- `GET` `/_application/search_application`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#basicauth)
- [Bearer auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#bearerauth)

## Description

Get information about search applications.

## Required authorization

* Cluster privileges: `manage_search_application`

## Query String Parameters

- `q` (string)
  Query in the Lucene query string syntax.
- `from` (number · default: 0)
  Starting offset.
- `size` (number)
  Specifies a max number of results to get.

## Response

`application/json`

- `count` (number)
- `results` ([] SearchApplication)
  - `indices` ([] string IndexName)
    Indices that are part of the Search Application.
  - `analytics_collection_name` (string Name)
    Analytics collection associated to the Search Application.
  - `template` ({} SearchApplicationTemplate)
    Search template to use on search operations.
    - `script` (string Script)
      The associated mustache template.
  - `name` (string Name)
    Search Application name
  - `updated_at_millis` (EpochTimeUnitMillis)
    Last time the Search Application was updated.
## Code Examples

#### Console

```console
GET _application/search_application?from=0&size=3&q=app*
```

#### JavaScript

```javascript
const response = await client.searchApplication.list({
  from: 0,
  size: 3,
  q: "app*",
});
```

#### Python

```python
resp = client.search_application.list(
    from_="0",
    size="3",
    q="app*",
)
```

#### curl

```curl
curl -X GET "$ELASTICSEARCH_URL/_application/search_application?from=0&size=3&q=app*" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"
```

#### Java

```java
client.searchApplication().list(l -> l
    .from(0)
    .q("app*")
    .size(3)
);
```

#### C#

```c#
var response = await client.SearchApplication
    .ListAsync(d1 => d1
        .From(0)
        .QueryLuceneSyntax("app*")
        .Size(3)
    );
```

#### PHP

```php
$resp = $client->searchApplication()->list([
    "from" => "0",
    "size" => "3",
    "q" => "app*",
]);
```

#### Ruby

```ruby
response = client.search_application.list(
  from: "0",
  size: "3",
  q: "app*"
)
```

## Response Examples

#### Search applications list response example1

A succesful response from `GET _application/search_application?from=0&size=3&q=app*` returns the first three search applications whose names start with `app`.

```json
{
  "count": 2,
  "results": [
    {
      "name": "app-1",
      "updated_at_millis": 1690981129366
    },
    {
      "name": "app-2",
      "updated_at_millis": 1691501823939
    }
  ]
}
```