# Retrieve Employees, Managers and Custom Fields from UKG Ready

**URL:** <https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911>\
**Category:** Integrator.io\
**Tags:** ukg-ready\
**Created:** [March 20, 2025, 10:44pm UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911 "2025-03-20T22:44:45Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![Dana\_Reed](https://avatars.discourse-cdn.com/v4/letter/d/f6c823/32.png) [@Dana\_Reed](https://connective.celigo.com/u/Dana_Reed)\
**Post date:** [March 20, 2025, 10:44pm UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/1 "2025-03-20T22:44:45Z")

</div>

Trying to Export All Changed Employees from UKG Ready. I'm able to create the UKG Ready connection and works, but accessing Employees API fails.  
We have only one Company and that is applied in the connection; however, the export also has required company field.  
I get this error:  
Status: undefined  
Message: {"errors":[{"code":10000,"message":"Company not found."}],"user\_messages":[{"severity":"ERROR","text":"Company not found.","details":{"code":10000}}]}

---

<div class="post-metadata">

**Author:** ![kellyizer](https://sea1.discourse-cdn.com/flex001/user_avatar/connective.celigo.com/kellyizer/32/4369_2.png) [@kellyizer](https://connective.celigo.com/u/kellyizer)\
**Post date:** [March 21, 2025, 9:36pm UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/2 "2025-03-21T21:36:58Z")

</div>

Dana,

I wanted to confirm whether you followed the steps outlined in the following documentation to obtain your Company ID:  
[How to Get Company ID and Company Name in UKG Ready](https://ukg.cloudapper.ai/ukg-help/how-to-get-company-id-and-company-name-in-ukg-ready/)

The error you're encountering suggests that the Company ID (CID) included in the API request may be incorrect, or that the API key being used does not have access to the specified company. To ensure everything is set up correctly, please double-check both the CID and the API key configuration.

### Retrieving Your API Key

1. Log in to your UKG Ready account.
2. Navigate to: **Company Settings** → **Global Setup** → **Company Setup** → **Login Config** → **API Keys**.
3. Click **Generate** to create a new key.
4. Copy and securely store the **API Key**.

According to UKG Ready's API documentation for the [Changed Employees endpoint](https://secure7.saashr.com/ta/docs/rest/public/#), the CID is included in the request URL. However, this relies on having the correct configuration in place.

 ![The image shows a developer hub webpage detailing the API documentation for retrieving changed employee records, including a GET request example and JSON response sample. (Captioned by AI)](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/d/dd0528fc267bf66dfc70068c3220cb26aee803b7.jpeg)

Please validate that you are populating the correct CID number on the connector screen

 ![The image is a screenshot of the Celigo interface, showing the "Edit Export" page with fields for resource selection and API endpoint details. (Captioned by AI)](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/5/5b399fd5988f7451c3fb8d5c93d07c8ec85c9ae0.jpeg)

Let us know if you continue to see issues after verifying the above.

---

<div class="post-metadata">

**Author:** ![Dana\_Reed](https://avatars.discourse-cdn.com/v4/letter/d/f6c823/32.png) [@Dana\_Reed](https://connective.celigo.com/u/Dana_Reed)\
**Post date:** [March 22, 2025, 12:23am UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/3 "2025-03-22T00:23:14Z")

</div>

Hi Yes, I have the CID, etc. inserted. It's weird.

 ![The image shows an API connection error message indicating "Company not found" with error code 10000, alongside a request URL and parsed output details. (Captioned by AI)](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/7/758c155de4db882dc3d417d7197b17d88e15356b.png)

I have Postman working - the API Key, the Secret and Client ID are set in the iClient.  
I really have no clue why it keeps stating that Company doesn't exist. It could be because I'm using the short name. In Postman I have to include %7C preceding the short name with is "|" URL Encoded. A "!" or "|" needs to precede the "short company name" if used. Please refer to: [Developer Hub](https://secure7.saashr.com/ta/docs/rest/public/)

Extract from documentation below-  
"" Operations

API operations act on resources, which are business entities that are stored or computed. Each operation consists of an HTTP method plus a URL. A complete list of operations is available in the API reference documentation.

### Syntax and URL form

The API's syntax is elegant in its simplicity:

HTTP method + URL

`GET /v2/companies/12345/employees/210` returns data associated with person number 210 for company 12345

Our URLs are likewise constructed according to a consistent format:

`https://{POD}/ta/rest/{major version}/{resource}/{resource_id}[/{subresource}]`

**note:** The individual Company Resource within the URL is referenced by default using the numeric identifier of a company within the system. For ease of use the APIs also allow the use of the company shortname, when used with this identifier the shortname **must** be preceeded by either a | or ! ""

---

<div class="post-metadata">

**Author:** ![Dana\_Reed](https://avatars.discourse-cdn.com/v4/letter/d/f6c823/32.png) [@Dana\_Reed](https://connective.celigo.com/u/Dana_Reed)\
**Post date:** [March 22, 2025, 12:42am UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/4 "2025-03-22T00:42:30Z")

</div>

However, I know the CID was working as I was able to create the iClient. If I try to put in the "|" or "%7C" preceding the company short name, I get this different error

 ![2025-03-21_17-30-31](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/9/97f481223a0df946f09afb696d997c3e55a2e692.png)

---

<div class="post-metadata">

**Author:** ![kellyizer](https://sea1.discourse-cdn.com/flex001/user_avatar/connective.celigo.com/kellyizer/32/4369_2.png) [@kellyizer](https://connective.celigo.com/u/kellyizer)\
**Post date:** [March 26, 2025, 12:02am UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/6 "2025-03-26T00:02:16Z")

</div>

Dana,  
If it is working in Postman you should be able to access that same call via IO.  
Can you please try changing the view in your flow to the HTTP view and then you can copy the URL you are using in Postman into IO and test it that way. You can also add any other headers or such that you may have been using in Postman (if any)

In the HTTP view you have explicit control over the API and can input whatever you need. The Simple view is a way we try to make it easier to work with a systems API by turning the API options into dropdown menus, but we never lock you into only using what is in those drop downs.

 ![The image shows a Celigo interface for editing an HTTP export, with fields for naming, describing, and configuring the export, including specifying a relative URI for a GET request. (Captioned by AI)](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/5/5033e46fdbab697c91bc1282e122ab35ad94bf3f.jpeg)

---

<div class="post-metadata">

**Author:** ![Dana\_Reed](https://avatars.discourse-cdn.com/v4/letter/d/f6c823/32.png) [@Dana\_Reed](https://connective.celigo.com/u/Dana_Reed)\
**Post date:** [April 4, 2025, 4:14pm UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/7 "2025-04-04T16:14:17Z")

</div>

Hi Kelly, yes, this was the solution and had done this, but I had an incorrect relative URL which when I fixed it, worked right away.

Thank you for you help.

---

<div class="post-metadata">

**Author:** ![Davies\_Chama](https://avatars.discourse-cdn.com/v4/letter/d/858c86/32.png) [@Davies\_Chama](https://connective.celigo.com/u/Davies_Chama)\
**Post date:** [December 18, 2025, 12:29am UTC](https://connective.celigo.com/t/retrieve-employees-managers-and-custom-fields-from-ukg-ready/3911/8 "2025-12-18T00:29:02Z")

</div>

Hi @kellyizer

I hope you’re doing well.

I came across your interaction with Dana, and unfortunately I am encountering a similar issue. I was able to set up the UKG Ready connection in IO and its working, however, when I made a call to get employees to this endpoint: **/v2/companies/{cid}/employees** , I keep getting this error below:  
Status: 404  
Message: {"errors":[{"code":10000,"message":"Company not found."}],"user\_messages":[{"severity":"ERROR","text":"Company not found.","details":{"code":10000}}]}

I followed the steps outlined in the UKG Read documentation to obtain the company ID and the API key. I added the company in the Relative URI. I have no idea why the company is not found when I make a request.

I will greatly appreciate any assitance you can offer.

 ![image](https://us1.discourse-cdn.com/flex001/uploads/celigo/original/2X/5/5807883794bb0f6799792dd69bb650b53f21d548.png)
