POST
/
api
/
v1
/
employee
/
consent-data
/
Submit Employee Consent Data
curl --request POST \
  --url https://{env}.tartanhq.com/api/v1/employee/consent-data/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "org": "9e3ba089-5cb6-407c-93db-e3b7ccaff3ed",
  "employee_id": "0078",
  "consent_language": "I have new consent.",
  "consent_timestamp": "2024-11-20T10:30:00Z",
  "consent_expiry": "2024-11-28T10:30:00Z"
}'
{
  "requestId": "d4e04a3f-08c2-45bd-a7de-ea37fc632a1f",
  "message": "success",
  "data": {
    "id": "7",
    "employeeId": "5",
    "name": "Manas Mallik",
    "email": "manas@tartanhq.com",
    "personalEmail": "manas.mallik@gmail.com",
    "doj": "2021-06-01",
    "dob": "1983-06-08",
    "status": "Active",
    "employmentType": "Permanent",
    "gender": "Male",
    "pan": "************",
    "aadhar": "************",
    "uan": "************",
    "mobileNumber": "************",
    "maritalStatus": "Married",
    "nationality": "Indian",
    "fatherName": "Ritesh Mallik",
    "bloodGroup": "AB +ve",
    "designation": "NOT AVAILABLE",
    "department": "Engineering",
    "grade": "D-3",
    "groupName": "NOT AVAILABLE",
    "costCenter": "NOT AVAILABLE",
    "companyName": "NOT AVAILABLE",
    "terminationDate": "",
    "manager": "Meet Semlani",
    "managerEmail": "NOT AVAILABLE",
    "managerEmail2": "NOT AVAILABLE",
    "managerEmail3": "NOT AVAILABLE",
    "managerEmail4": "NOT AVAILABLE",
    "managerEmail5": "NOT AVAILABLE",
    "countryCode": "IN",
    "bankDetails": {
      "accountNumber": "************",
      "ifscCode": "************",
      "bankName": "SBI"
    },
    "currentAddress": {
      "addressPincode": "560080",
      "addressCity": "Banglore",
      "addressCountry": "India",
      "addressState": "Karnataka",
      "addressLine": "Sadashiva Nagar Armane Nagar"
    },
    "permanentAddress": {
      "addressPincode": "226001",
      "addressCity": "Luknow",
      "addressCountry": "India",
      "addressState": "Uttar Pradesh",
      "addressLine": "Yarana Nagar Luknow"
    },
    "jobLocation": {
      "pincode": "NOT AVAILABLE",
      "city": "NOT AVAILABLE"
    },
    "employeeMetadata": {
      "marriageDate": "NOT AVAILABLE"
    },
    "dependentDetails": [
      {
        "name": "Sohan Negi",
        "relation": "Father",
        "dob": "NOT AVAILABLE",
        "email": "NOT AVAILABLE",
        "gender": "NOT AVAILABLE",
        "mobileNumber": "NOT AVAILABLE",
        "profession": "NOT AVAILABLE"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Body

application/json
org
string<uuid>
required

Organization UUID

Example:

"9e3ba089-5cb6-407c-93db-e3b7ccaff3ed"

employee_id
string
required

Unique employee ID within the organization

Example:

"0078"

Consent statement or text given by the employee

Example:

"I have new consent."

Timestamp when the consent was given

Example:

"2024-11-20T10:30:00Z"

Consent expiration datetime

Example:

"2024-11-28T10:30:00Z"

Response

Employee details retrieved successfully

requestId
string
Example:

"d4e04a3f-08c2-45bd-a7de-ea37fc632a1f"

message
string
Example:

"success"

data
object