Reten Docs
Operators

List Operators

Get a paginated list of operators with filters.

GET /api/operators

Returns a paginated list of operators with optional filters.

Auth: Required — MANAGE_OPERATORS permission

Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number
per_pagenumber25Items per page (max 100)
searchstring-Search by name or email
typestring-Filter by operator type
is_activeboolean-Filter by active status

Example

curl "https://api.reten.ai/api/operators?type=SALESMAN&page=1&limit=10" \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/operators',
  {
    params: {
      type: 'SALESMAN',
      page: 1,
      limit: 10,
    },
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Response 200 OK

{
  "data": [
    {
      "id": "cc0e8400-e29b-41d4-a716-446655440000",
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "type": "SALESMAN",
      "isActive": true
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}