---
title: "Retrieve an employee"
url: "https://docs.unified.to/hris/employee/Retrieve_an_employee"
description: "API reference for Retrieve an employee. Launch multiple pre-built Employee integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-21T18:13:10.973Z"
---
# Retrieve an employee

 GET/hris/{connection\_id}/employee/{id}

## Parameters

**fields**string array 

id

created\_at

updated\_at

name

first\_name

last\_name

emails

title

manager\_id

employment\_status

gender

telephones

date\_of\_birth

employee\_number

hired\_at

terminated\_at

termination\_reason

marital\_status

employment\_type

address

language\_locale

currency

timezone

image\_url

company\_id

pronouns

employee\_roles

compensation

salutation

bio

ssn\_sin

groups

locations

metadata

storage\_quota\_allocated

storage\_quota\_used

storage\_quota\_available

relationships

has\_mfa

timeoff\_days\_total

timeoff\_days\_used

raw

Fields to return

**raw**string 

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

**connection\_id**string  required 

ID of the connection

**id**string  required 

ID of the Employee

## Returns

[HrisEmployee](/hris/employee/model)

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**name**string 

**first\_name**string 

**last\_name**string 

**emails** array 

**title**string 

**manager\_id**string 

**employment\_status** enum

Valid values:

 "ACTIVE" 

 "INACTIVE" 

**gender** enum

Valid values:

 "MALE" 

 "FEMALE" 

 "INTERSEX" 

 "TRANS" 

 "NON\_BINARY" 

**telephones** array 

**date\_of\_birth**date 

YYYYMM/DD

**employee\_number**string 

the company's ID for this employee

**hired\_at**date 

The employee's start date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**terminated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**termination\_reason**string 

**marital\_status** enum

Valid values:

 "MARRIED" 

 "SINGLE" 

**employment\_type** enum

Valid values:

 "FULL\_TIME" 

 "PART\_TIME" 

 "CONTRACTOR" 

 "INTERN" 

 "CONSULTANT" 

**address**object 

**language\_locale**string 

**currency**string 

**timezone**string 

**image\_url**string 

This link expires after 1 hour. 

**company\_id**string 

(reference to HrisCompany)

**pronouns**string 

**employee\_roles** enum array 

Valid values:

 "ADMIN" 

 "MANAGER" 

 "RECRUITER" 

 "SALESREP" 

 "INTERVIEWER" 

**compensation** array 

**salutation**string 

Mr. Mrs. Ms.

**bio**string 

**ssn\_sin**string 

**groups** array 

Which groups/teams/units that this employee/user belongs to. May not have all of the Group fields present, but should have id, name, or email.

**locations** array 

**metadata** array 

**storage\_quota\_allocated**number 

**storage\_quota\_used**number 

**storage\_quota\_available**number 

**relationships** array 

the employee's personal relationships (eg. emergency contacts, spouse, dependants, ...)

**has\_mfa**boolean 

does the user/employee have multi-factor authentication enabled

**timeoff\_days\_total**number 

Total time off allowance for the current leave period, in days (when reported by the provider)

**timeoff\_days\_used**number 

Time off days used or booked in the current leave period (when reported by the provider)

**raw**any 

## Code Samples

### Node.js SDK

```
import { UnifiedTo } from '@unified-api/typescript-sdk';

const sdk = new UnifiedTo({
    security: {
        jwt: '<YOUR_API_KEY_HERE>',
    },
});

const connectionId = '5de520f96e439b002043d8dc';

const id = '1234';

const results = await sdk.hris.getHrisEmployee({ connectionId, id, 
    fields: '',
    raw: '',
 });
```

### Node.js (axios)

```
const options = {
  method: 'GET',
  url: 'https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);
```

### Java

```
AsyncHttpClient client = new DefaultAsyncHttpClient();

client.prepare("GET", "https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw=")
  .setHeader("accept", "application/json")
  .setHeader("authorization", ".....")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();
```

### Go

```
import (
	"fmt"
	"net/http"
	"io/ioutil"
)

url := `https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw=

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("accept", "application/json")
req.Header.Add("authorization", ".....")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
```

### Python

```
import requests

url = "https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw="

headers = {
    "accept": "application/json",
    "authorization": "....."
}

response = requests.get(url, headers=headers)
```

### PHP

```
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: ....."
  ],
]);
```

### Ruby

```
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = '....'

response = http.request(request)
puts response.read_body
```

### cURL

```
curl --request GET \
  --url 'https://api.unified.to/hris/5de520f96e439b002043d8dc/employee/5de520f96e439b002043d8d8?fields=&raw=' \
  --header 'accept: application/json' \
  --header 'authorization: .....'
```