> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kler.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Operators

> Add cashiers and staff to a session and track their transactions.

Operators represent the people collecting payments at your event — cashiers, gate staff, or ticket scanners. Each operator can be linked to transactions for accountability.

## Add operator

**POST** `/v1/sessions/:session_id/operators`

<ParamField body="name" type="string" required>
  Operator's full name.
</ParamField>

<ParamField body="email" type="string">
  Operator's email address.
</ParamField>

<ParamField body="phone" type="string">
  Operator's phone number.
</ParamField>

<ParamField body="role" type="string" default="cashier">
  Role label (e.g. `cashier`, `supervisor`).
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.kler.africa/v1/sessions/3f1e2d.../operators \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Amina Bello",
      "phone": "08012345678",
      "role": "cashier"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": {
      "id": "op_...",
      "session_id": "3f1e2d...",
      "name": "Amina Bello",
      "phone": "08012345678",
      "role": "cashier",
      "created_at": "2025-08-01T09:00:00.000Z"
    }
  }
  ```
</ResponseExample>

***

## List operators

**GET** `/v1/sessions/:session_id/operators`

<RequestExample>
  ```bash theme={null}
  curl https://api.kler.africa/v1/sessions/3f1e2d.../operators \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

***

## Get operator transactions

**GET** `/v1/sessions/:session_id/operators/:operator_id/transactions`

Returns all transactions linked to a specific operator.

<RequestExample>
  ```bash theme={null}
  curl https://api.kler.africa/v1/sessions/3f1e2d.../operators/op_.../transactions \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>