Get Employee by User ID | Deel. PayAndBill API Documentation

{
  "id": 1000,
  "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
  "remoteId": 55,
  "remoteSource": "classic",
  "isLocked": false,
  "personalDetails": {
    "uuid": "502519de-0287-4bb8-a3f1-d269eb850086",
    "userUuid": "rcjJX5K6v5XzoyNVWqHXS6",
    "nameInitials": "JD",
    "nameTitle": "Mr",
    "nameFirst": "John",
    "nameLast": "Doe",
    "nameMiddle": "A",
    "nameKnownAs": "Johnny",
    "dateOfBirth": "1990-01-15",
    "gender": "Male",
    "maritalStatus": "Single",
    "contact": {
      "primaryEmail": "john.doe@example.com",
      "payslipEmail": "john.doe.payslip@example.com",
      "phoneNumber": "+441234567890",
      "mobileNumber": "+447700123456",
      "emailPayslip": true,
      "sendNotification": true
    },
    "postalAddress": {},
    "emergencyContact": {},
    "remoteId": 55,
    "remoteSource": "classic",
    "nationality": "British"
  },
  "engagement": [
    {
      "uuid": "8a4f3e2d-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
      "payrollCompanyId": "1",
      "payType": "PAYE",
      "engagementType": "Full Time",
      "startDate": "2024-01-15",
      "terminationDate": "2023-01-15",
      "status": "ACTIVE",
      "hoursNormallyWorked": "MoreThan30",
      "remoteId": 101,
      "remoteSource": "classic",
      "job": [
        {}
      ]
    }
  ],
  "bank": {
    "uuid": "string",
    "accountName": "John Doe",
    "sortCode": "123456",
    "accountNumber": "12345678",
    "bankReference": "string",
    "buildingSocietyNumber": "string"
  },
  "tax_information": {
    "uuid": "string",
    "nationalInsuranceNumber": "AB123456C",
    "niTable": "A",
    "director": true,
    "week1Month1": true,
    "taxCode": "1257L",
    "haveP45Form": true,
    "haveStudentLoan": true,
    "studentLoanType": "None",
    "havePostGradLoan": true,
    "employeeDeclaration": "A",
    "taxInfoType": "TAX_CODE",
    "p45DemoLink": "string"
  },
  "lastSyncStatus": {
    "JOB": "synced",
    "TAX": "synced"
  },
  "employeeStatus": 1,
  "employeeState": "active",
  "externalEmployeeNumber": "string"
}

Retrieve a single employee’s full details — personal info, engagements, bank, and tax — by their user ID.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

userIdstringRequired

User ID of the employee

Response

Successful Response

idinteger

Internal employee ID

userUuidstring

remoteIdinteger

remoteSourcestring

isLockedboolean

Whether the employee account is locked

personalDetailsobject

engagementlist of objects

bankobject

tax_informationobject

Tax and payroll information for the active engagement

lastSyncStatusobject

Sync status per category (e.g. JOB, TAX, BANK, EMPLOYEE)

employeeStatusinteger

Numeric employee status code

employeeStateenum

externalEmployeeNumberstring

External employee number from integration (e.g. PaySpace)

Errors

404

Not Found Error

$	curl https://{{baseurl}}/employees/55 \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Response

Errors