---
title: "List Executors"
method: POST
path: "/executors/search"
tags: ["Executors"]
---

# List Executors

`POST /executors/search`

Get list of executors with optional filtering.

Returns active executors from memory combined with completed executors from database.

Filters:
- `account_names`: Filter by specific accounts
- `connector_names`: Filter by connectors
- `trading_pairs`: Filter by trading pairs
- `executor_types`: Filter by executor types
- `status`: Filter by status (RUNNING, TERMINATED, etc.)

Returns paginated list of executor summaries.

## Request body

- ExecutorFilterRequest — Request to filter and list executors.
  - `limit` integer — Number of items per page
  - `cursor` string, nullable — Cursor for next page
  - `account_names` string[], nullable — Filter by account names
  - `connector_names` string[], nullable — Filter by connector names
  - `trading_pairs` string[], nullable — Filter by trading pairs
  - `executor_types` string[], nullable — Filter by executor types
  - `status` string, nullable — Filter by status (RUNNING, TERMINATED, etc.)

## Response `200`

Successful Response

- PaginatedResponse — Generic paginated response.
  - `data` object[], required
  - `pagination` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)