API Reference / API Methods / Manage indices / Index exists
Required API Key: any key with the settings ACL
Method signature
$index->exists()

About this method # A

We released a new version of the PHP API client in public beta. Read the beta documentation for more information.

Check if an index exists or not.

You can initialize an index with any name. The index is created on Algolia’s servers when you add objects or set settings. To prevent accidentally creating new indices, or changing existing indices, you can use the exists method. The exists method returns a boolean that indicates whether an initialized index has been created.

Be careful when using this method to execute code conditionally. Because index operations are asynchronous, an index might not yet exist when you call the exist method, but it might exist when the conditional code runs. Be mindful of the surrounding code, and of any process that might change your indices.

Examples # A

Check if an index exists#

1
2
3
4
5
6
7
8
9
10
11
<?php
require_once __DIR__."/vendor/autoload.php";
use Algolia\AlgoliaSearch\SearchClient;

// Use an API key with `settings` ACL
$client = SearchClient::create(
  'AJ0P3S7DWQ', 'YourAPIKey'
);
$index = $client->initIndex('indexName');

$index->exists();

Parameters # A

This method doesn't take any parameters.

Response # A

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here. You can view the response in the logs (using the getLogs method).

JSON format#

This method returns true if the index exists, and false otherwise.

Did you find this page helpful?
PHP v3