Get an employee
GET /v1/employees/{employee}
Returns one employee in your workspace by the public employee id.
Requires a workspace API-client key with the employees:read scope.
Example request
Section titled “Example request”This example reads one employee. It does not change any records. Replace the ID with an id from List employees or from the result of a sync.
curl --request GET 'https://api.feedbackpulse.com/v1/employees/emp_01J9EXAMPLE' \ --header "Authorization: Bearer $FEEDBACKPULSE_API_KEY" \ --header 'Accept: application/json'Example response
Section titled “Example response”HTTP 200 OK
{ "data": { "id": "emp_01J9EXAMPLE", "name": "Alex Example", "email": "alex@example.com", "job_title": "Product Designer", "department": null, "employee_number": null, "type": "full-time", "employment_status": "active", "account_status": "not-invited", "access_status": "enabled", "is_manager": false, "hire_date": null, "termination_date": null, "created_at": "2026-11-02T09:00:00+00:00", "updated_at": "2026-11-02T09:00:00+00:00", "manager": null }}Request
Section titled “Request”Put the employee id in the path. The request has no body and no query parameters.
Headers
Section titled “Headers”| Header | Required | Description |
|---|---|---|
Authorization |
Yes | Bearer API-client key with employees:read. |
Path parameters
Section titled “Path parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
employee |
string | Yes | Canonical public employee identifier, for example emp_01H.... |
Response
Section titled “Response”A 200 response contains the employee in data. A 404 response means that no employee with this id exists in the workspace of the API key.
| Field | Type | Required | Description |
|---|---|---|---|
data |
object | Yes | |
data.id |
string | Yes | Canonical public employee identifier, for example emp_01H.... |
data.name |
string | Yes | |
data.email |
string | Yes | Format: email. |
data.job_title |
string or null | No | |
data.department |
string or null | No | |
data.employee_number |
string or null | No | |
data.type |
string or null | No | |
data.employment_status |
string | Yes | Values: active, terminated. |
data.account_status |
string or null | Yes | Null means activation history is unknown for a legacy terminated employee. Values: not-invited, invited, active, null. |
data.access_status |
string | Yes | Values: enabled, disabled. |
data.is_manager |
boolean | Yes | |
data.hire_date |
string or null | No | Format: date. |
data.termination_date |
string or null | No | Format: date. |
data.created_at |
string | Yes | Format: date-time. |
data.updated_at |
string | Yes | Format: date-time. |
data.manager |
object or null | No | |
data.manager.id |
string | No | Canonical public employee identifier, for example emp_01H.... |
data.manager.name |
string | No | |
meta |
object | No | |
meta.warnings |
array | No |
Status codes
Section titled “Status codes”| HTTP status | Meaning |
|---|---|
200 |
Employee found |
401 |
Missing or invalid bearer token |
403 |
Authenticated but lacking the required API client scope |
404 |
Resource not found in the API client’s tenant scope |
429 |
Rate limit exceeded |
See API errors and rate limits or download the OpenAPI contract.