# Query for machine instances using the indicated index.

**GET /machines/{machineSlug}/indexes/{index}/query**

Using an index specified during machine creation and defined during machine version creation,
query for instances of the provided machine that have an indexed value that matches the
provided filters.



## Servers
- Production server: https://api.statebacked.dev (Production server)


## Authentication methods
- Bearer auth


## Parameters

#### Path parameters
- **machineSlug** (string)
  The slug/name for the machine definition.
- **index** (string)
  The name for the machine index.

#### Query parameters
- **op** (string)
  The operation for the filter.
- **value** (string)
  The value for the filter.
- **dir** (string)
  The sort direction for the index.
- **limit** (number)
  The maximum number of items to return.
- **cursor** (string)
  The cursor returned from a previous call to query.


## Responses
### 200: The query was executed successfully.

#### Body Parameters:  (object)
- **instances** (array[object])
  
- **cursor** (string)
  

### 403: The request was unauthorized.

#### Body Parameters:  (object)
- **error** (string)
  A description of the error.
- **code** (string)
  A code specifying the type of error.


[Powered by Bump.sh](https://bump.sh)