# List replicas

**GET /v1/replicas**

List replicas with pagination with optional filtering. Only Replicas that are public or belong to the authenticated user are returned.


## Servers
- https://api.sensay.io: https://api.sensay.io ()


## Authentication methods
- Organization service token & User
- Organization service token


## Parameters
### Headers
- **X-API-Version** (string)



### Query parameters
- **owner_uuid** (string)
  Filters by the owner UUID of the Replicas
- **ownerID** (string)
  The replica owner ID.
- **pageIndex** (integer)
  Pagination: The page index to return
- **pageSize** (integer)
  Pagination: The number of items per page
- **page** (integer)
  Pagination: The page number to return (deprecated, use pageIndex instead)
- **page_index** (integer)
  Pagination: The page index to return (deprecated, use pageIndex instead)
- **page_size** (integer)
  Pagination: The number of items per page (deprecated, use pageSize instead)
- **slug** (string)
  Filters by the replica's slug
- **search** (string)
  Search: by name of Replica, sorted in ascending order
- **tags** (array[string])
  Filters by tags associated to Replicas
- **sort** (string)
  Sorts by name or popularity of Replicas in ascending order
- **integration** (string)
  Filters by integration


## Responses
### 200
List of Replicas

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **type** (string)

- **items** (array[object])
  Array of replica items for the current page. Will be an empty array if no items exist.
- **total** (integer)
  The total number of replica items available across all pages

### 400
Bad Request

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 401
Unauthorized

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 404
Not Found

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 415
Unsupported Media Type

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 500
Internal Server Error

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting
- **inner_exception** (object)
  The inner exception


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