---
title: "Get a specific employee profile and balance"
method: GET
path: "/employees/{employee_id}"
---

# Get a specific employee profile and balance

`GET /employees/{employee_id}`

## Request

- Base URL: `https://api.boyahq.com/v1`
- URL: `https://api.boyahq.com/v1/employees/{employee_id}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/boyahq/apis/boya-employees-api/docs/employees/:employee_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `employee_id` integer, required

## Query parameters

- `org_wallet_ref` string, required

## Response `200`

Successful response

- Employee
  - `id` string
  - `name` string
  - `phone` string
  - `team_code` string
  - `organization_email` string
  - `role` string
  - `accno` string: employee wallet accno
  - `balance` number, double: account balance
  - `status` 'ACTIVE' | 'SUSPENDED'
  - `createdAt` string, date

## Other responses

- `401`: Unauthorized — missing or invalid API key.
- `404`: Not found — the requested resource does not exist.

## Changes

- **2026-08-14** `190d4c90e3ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/boyahq/apis/boya-employees-api/changes/employees/:employee_id/get.md)

---

[API](https://skmtc.dev/boyahq/apis/boya-employees-api.md) - [All operations](https://skmtc.dev/boyahq/apis/boya-employees-api/llms.txt) - [OpenAPI document](https://skmtc.dev/boyahq/apis/boya-employees-api/revisions/190d4c90e3ab?raw)