---
title: "Get entities with filtering"
method: GET
path: "/api/v1/entities"
tags: ["entities"]
---

# Get entities with filtering

`GET /api/v1/entities`

Retrieve entities with optional filtering and pagination

## Query parameters

- `search` string
- `organization` string
- `sortBy` 'createdAt' | 'name' | 'email' | 'totalBids' | 'successRate'
- `sortOrder` 'asc' | 'desc'
- `limit` number
- `offset` number

## Response `200`

List of entities

- EntityResponseDto[]
  - `id` string, required — Unique entity identifier
  - `name` string, required — Entity name
  - `email` string, required — Contact email address
  - `organization` string — Organization name
  - `website` string — Website URL
  - `status` 'active' | 'suspended' | 'inactive', required — Entity status
  - `createdAt` string, date-time, required — Entity creation timestamp
  - `updatedAt` string, date-time, required — Last update timestamp
  - `lastActivityAt` string, date-time — Last activity timestamp
  - `metadata` object — Additional entity metadata
  - `totalBids` number, required — Total number of bids submitted
  - `successfulBids` number, required — Number of successful bids
  - `successRate` number, required — Bid success rate (0-1)
  - `activeApiKeys` number, required — Number of active API keys
  - `rateLimitUsage` number, required — Current rate limit usage percentage
  - `isActive` boolean, required — Whether entity is currently active
  - `hasApiKeys` boolean, required — Whether entity has any API keys
  - `verificationStatus` 'unverified' | 'pending' | 'verified' | 'rejected', required — Entity verification status

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification.md) · [All operations](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/manifoldfinance/eigenlayer-public-api-specification/revisions/068b24703dfe/schema)