Find employee

Tuum provides several API endpoints that let you either find a specific employee or search across multiple employees.

Find employee by ID

Use the Find employee by ID endpoint to retrieve data for a specific employee by providing their technical ID.

Shell (bash)

curl -L -X GET 'https://auth-api.sandbox.tuumplatform.com/api/v1/employees/ID-1116' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEyLTE4VDEwOjI3OjA3IiwiZXhwIjoxNzY2MDUzNjI3LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.BDrfwE3rSK7nAj434UA0MtOV76g-RyB8AVcQu3bUKTQ'

Find employee by username

Use the Find employee by username endpoint to retrieve data for a specific employee by providing their username.

Shell (bash)

curl -L -X GET 'https://auth-api.sandbox.tuumplatform.com/api/v1/employees/username?username=your_first_application' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEyLTE4VDEwOjI3OjA3IiwiZXhwIjoxNzY2MDUzNjI3LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.BDrfwE3rSK7nAj434UA0MtOV76g-RyB8AVcQu3bUKTQ'

Find multiple employees by IDs

Use the Find employee by IDs endpoint to retrieve data for multiple predefined employees by providing their technical IDs.

Shell (bash)

curl -L -X GET 'https://auth-api.sandbox.tuumplatform.com/api/v1/employees/search?employeeIds=ID-1116%2C%20ID-1008' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEyLTE4VDEwOjI3OjA3IiwiZXhwIjoxNzY2MDUzNjI3LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.BDrfwE3rSK7nAj434UA0MtOV76g-RyB8AVcQu3bUKTQ'

Search emloyees

Use the Search employees endpoint to retrieve list of employees.

Shell (bash)

curl -L -X GET 'https://auth-api.sandbox.tuumplatform.com/api/v1/employees' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEyLTE4VDEwOjI3OjA3IiwiZXhwIjoxNzY2MDUzNjI3LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.BDrfwE3rSK7nAj434UA0MtOV76g-RyB8AVcQu3bUKTQ'