---
title: "Gets a contractor"
method: GET
path: "/v{version}/Users/contractors/{ContractorId}"
tags: ["Users"]
---

# Gets a contractor

`GET /v{version}/Users/contractors/{ContractorId}`

## Path parameters

- `CompanyId` string, uuid, required
- `ContractorId` integer, required
- `version` string, required

## Headers

- `company-id` string, required

## Response `200`

Success

- UsersContractsQueriesGetContractorResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` UsersContractsQueriesContractorGetCompiledData
    - `contractorData` BilfloModelsUsersContractor
      - `companyUUId` string, uuid
      - `contractorId` integer
      - `userId` integer
      - `stateCode` string, nullable
      - `stateSubjectToTax` string, nullable
      - `stateWorking` string, nullable
      - `federalFilingStatusId` 1 | 2 | 3 | 4 | 5
      - `stateFilingStatusId` 1 | 2 | 3 | 4 | 5
      - `paycheckDeliveryId` 0 | 1
      - `stateFilingCode` string, nullable
      - `federalAllowance` number, double, nullable
      - `stateAllowance` number, double, nullable
      - `routingNumber` string, nullable
      - `accountNumber` string, nullable
      - `address1` string, nullable
      - `address2` string, nullable
      - `city` string, nullable
      - `zipCode` string, nullable
      - `is1099` boolean
      - `dateOfBirth` string, date-time, nullable
      - `gender` string, nullable
      - `socialSecurityNumber` string, nullable
      - `contractorCompany` string, nullable
      - `atsSyncId` string, nullable
      - `directDepositAccountNumber` string, nullable
      - `directDepositRoutingNumber` string, nullable
      - `reverseSynced` boolean, nullable
      - `isSickTimeEnabled` boolean
      - `isVacationTimeEnabled` boolean
      - `isHealthInsuranceEnabled` boolean
      - `additionalFederalWithholdings` number, double, nullable
      - `additionalStateWithholdings` number, double, nullable
      - `isI9OnFile` boolean, nullable
      - `isStateTaxExempt` boolean, nullable
      - `isFederalTaxExempt` boolean, nullable
      - `isHasTwoJobs` boolean, nullable
      - `otherIncomeAmount` number, double, nullable
      - `otherDeductionAmount` number, double, nullable
      - `paycheckDeliveryAccountTypeId` 1 | 2 | 3
      - `totalDependentClaimAmount` number, double, nullable
      - `user` BilfloModelsUsersUserProfile
        - `companyUUID` string, uuid
        - `userId` integer
        - `userName` string, nullable
        - `firstName` string, nullable
        - `middleName` string, nullable
        - `lastName` string, nullable
        - `title` string, nullable
        - `emailAddress` string, nullable
        - `phone` string, nullable
        - `phoneExt` string, nullable
        - `hasSuperPowers` boolean
        - `accountTypeId` 1 | 2 | 3
        - `isThemeEnable` boolean
        - `isRegistered` boolean
        - `isActive` boolean
        - `isElectronicDelivery` boolean
        - `customFields` BilfloModelsUsersUsersCustomFields[], nullable
          - `userId` integer
          - `customFieldId` integer
          - `customFieldName` string, nullable
          - `customFieldListItemId` integer
          - `customFieldListItemName` string, nullable
          - `customFieldUserId` integer
          - `customFieldFreeForm` string, nullable
          - `freeFormType` string, nullable
        - `usersInRoles` BilfloModelsUsersUsersInRole[], nullable
          - `userId` integer
          - `roleId` integer
    - `contractorUserProfile` BilfloModelsUsersUserProfile
      - `companyUUID` string, uuid
      - `userId` integer
      - `userName` string, nullable
      - `firstName` string, nullable
      - `middleName` string, nullable
      - `lastName` string, nullable
      - `title` string, nullable
      - `emailAddress` string, nullable
      - `phone` string, nullable
      - `phoneExt` string, nullable
      - `hasSuperPowers` boolean
      - `accountTypeId` 1 | 2 | 3
      - `isThemeEnable` boolean
      - `isRegistered` boolean
      - `isActive` boolean
      - `isElectronicDelivery` boolean
      - `customFields` BilfloModelsUsersUsersCustomFields[], nullable
        - `userId` integer
        - `customFieldId` integer
        - `customFieldName` string, nullable
        - `customFieldListItemId` integer
        - `customFieldListItemName` string, nullable
        - `customFieldUserId` integer
        - `customFieldFreeForm` string, nullable
        - `freeFormType` string, nullable
      - `usersInRoles` BilfloModelsUsersUsersInRole[], nullable
        - `userId` integer
        - `roleId` integer
    - `userCustomFields` BilfloModelsUsersUsersCustomFields[], nullable
      - `userId` integer
      - `customFieldId` integer
      - `customFieldName` string, nullable
      - `customFieldListItemId` integer
      - `customFieldListItemName` string, nullable
      - `customFieldUserId` integer
      - `customFieldFreeForm` string, nullable
      - `freeFormType` string, nullable
    - `contractorJobs` BilfloModelsUsersContractorJobData[], nullable
      - `jobId` integer, nullable
      - `statusId` integer
      - `addressId` integer, nullable
      - `clientId` integer, nullable
      - `contractorId` integer, nullable
      - `contractorTypeId` integer
      - `timeCardMethodId` integer
      - `timeCardDependencyId` integer, nullable
      - `isTimecardDocMandatory` boolean
      - `isTimecardUploadDocEnabled` boolean
      - `overtimeRuleId` integer, nullable
      - `jobTitle` string, nullable
      - `startDate` string, date-time
      - `endDate` string, date-time, nullable
      - `firstWeekEndingDate` string, date-time, nullable
      - `isPerDiemEnabled` boolean
      - `perDiemCalculationId` integer, nullable
      - `perDiemCollectionMethodId` integer, nullable
      - `isExpensesEnabled` boolean
      - `expensesCollectionMethodId` integer, nullable
      - `isSickTimeEnabled` boolean
      - `isWaiveMealPeriod` boolean
      - `isAllowSkipLunch` boolean
      - `workersCompCodeId` integer, nullable
      - `burdenManual` number, double, nullable
      - `logicFileId` string, uuid, nullable
      - `stateId` integer, nullable
      - `client` BilfloModelsClientsClient
        - `clientId` integer
        - `companyId` integer
        - `businessName` string, nullable
        - `clientCode` string, nullable
        - `isActive` boolean
        - `createdAt` string, date-time
        - `clientAddresses` BilfloModelsClientsClientAddress[], nullable
          - `addressId` integer, nullable
          - `addressCode` string, nullable
          - `clientId` integer
          - `companyName` string, nullable
          - `departmentName` string, nullable
          - `contactName` string, nullable
          - `address` string, nullable
          - `suite` string, nullable
          - `city` string, nullable
          - `state` string, nullable
          - `zipCode` string, nullable
          - `isActive` boolean, nullable
          - `isDefault` boolean, nullable
        - `clientContacts` BilfloModelsClientsClientContact[], nullable
          - `clientId` integer
          - `contactId` integer
          - `userId` integer
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `title` string, nullable
          - `phone` string, nullable
          - `phoneExt` string, nullable
          - `emailAddress` string, nullable
          - `createdAt` string, date-time
          - `isActive` boolean
          - `atsSyncId` string, nullable
          - `import_Contacts_ATSSyncId` string, nullable
      - `contractor` BilfloModelsUsersContractor
        - `companyUUId` string, uuid
        - `contractorId` integer
        - `userId` integer
        - `stateCode` string, nullable
        - `stateSubjectToTax` string, nullable
        - `stateWorking` string, nullable
        - `federalFilingStatusId` 1 | 2 | 3 | 4 | 5
        - `stateFilingStatusId` 1 | 2 | 3 | 4 | 5
        - `paycheckDeliveryId` 0 | 1
        - `stateFilingCode` string, nullable
        - `federalAllowance` number, double, nullable
        - `stateAllowance` number, double, nullable
        - `routingNumber` string, nullable
        - `accountNumber` string, nullable
        - `address1` string, nullable
        - `address2` string, nullable
        - `city` string, nullable
        - `zipCode` string, nullable
        - `is1099` boolean
        - `dateOfBirth` string, date-time, nullable
        - `gender` string, nullable
        - `socialSecurityNumber` string, nullable
        - `contractorCompany` string, nullable
        - `atsSyncId` string, nullable
        - `directDepositAccountNumber` string, nullable
        - `directDepositRoutingNumber` string, nullable
        - `reverseSynced` boolean, nullable
        - `isSickTimeEnabled` boolean
        - `isVacationTimeEnabled` boolean
        - `isHealthInsuranceEnabled` boolean
        - `additionalFederalWithholdings` number, double, nullable
        - `additionalStateWithholdings` number, double, nullable
        - `isI9OnFile` boolean, nullable
        - `isStateTaxExempt` boolean, nullable
        - `isFederalTaxExempt` boolean, nullable
        - `isHasTwoJobs` boolean, nullable
        - `otherIncomeAmount` number, double, nullable
        - `otherDeductionAmount` number, double, nullable
        - `paycheckDeliveryAccountTypeId` 1 | 2 | 3
        - `totalDependentClaimAmount` number, double, nullable
        - `user` BilfloModelsUsersUserProfile
          - `companyUUID` string, uuid
          - `userId` integer
          - `userName` string, nullable
          - `firstName` string, nullable
          - `middleName` string, nullable
          - `lastName` string, nullable
          - `title` string, nullable
          - `emailAddress` string, nullable
          - `phone` string, nullable
          - `phoneExt` string, nullable
          - `hasSuperPowers` boolean
          - `accountTypeId` 1 | 2 | 3
          - `isThemeEnable` boolean
          - `isRegistered` boolean
          - `isActive` boolean
          - `isElectronicDelivery` boolean
          - `customFields` BilfloModelsUsersUsersCustomFields[], nullable
            - `userId` integer
            - `customFieldId` integer
            - `customFieldName` string, nullable
            - `customFieldListItemId` integer
            - `customFieldListItemName` string, nullable
            - `customFieldUserId` integer
            - `customFieldFreeForm` string, nullable
            - `freeFormType` string, nullable
          - `usersInRoles` BilfloModelsUsersUsersInRole[], nullable
            - `userId` integer
            - `roleId` integer
      - `payBillItems` BilfloModelsContractJobsContractJobPayBillItemDetail[], nullable
        - `id` integer
        - `jobId` integer
        - `payBillItemId` integer
        - `costRate` number, double
        - `billRate` number, double
        - `includeInSales` boolean
        - `includeInCost` boolean
        - `burden` number, double
        - `isBurdened` boolean
        - `mapToPayroll` boolean
      - `customFields` BilfloModelsContractJobsContractJobCustomField[], nullable
        - `jobId` integer
        - `customFieldId` integer
        - `customFieldValue` string, nullable
      - `burdenItems` BilfloModelsContractJobsContractJobBurdenItem[], nullable
        - `burdenItemId` integer
        - `jobId` integer
        - `isWorkersCompCode` boolean
      - `jobApprovers` BilfloModelsContractJobsContractJobApprover[], nullable
        - `jobId` integer
        - `contactId` integer
        - `userId` integer
        - `canApproveExpenses` boolean
        - `canApprovePerDiem` boolean
        - `canApproveTime` boolean
        - `viewInvoices` boolean
      - `periodEndDateId` integer
      - `transactionText` string, nullable
      - `isActive` boolean
      - `regularPayRate` number, double
      - `approverId` integer
      - `approverName` string, nullable
    - `contractorChecks` BilfloModelsUsersContractorCheck[], nullable
      - `date` string, date-time
      - `type` string, nullable
      - `amount` number, double
    - `userDocumentsData` BilfloModelsUsersUserDocumentData[], nullable
      - `id` integer
      - `contractorId` integer
      - `userId` integer
      - `fileName` string, nullable
      - `fileType` string, nullable
      - `contractorVisible` boolean
      - `isDelivered` boolean
      - `documentType` string, nullable
      - `documentYear` integer
      - `documentDate` string, date-time, nullable
      - `jobTitle` string, nullable
      - `fileOnServerUrl` string, nullable
    - `userWorkStatus` BilfloModelsCompanySettingsContractorWorkStatusInfo[], nullable
      - `id` integer
      - `userId` integer, nullable
      - `contractorId` integer, nullable
      - `jobId` integer, nullable
      - `dateEffective` string, date-time, nullable
      - `workStatus` string, nullable
    - `userSickBenefits` BilfloModelsUsersUserSickBenefits
      - `userId` integer
      - `isSickTimeEnabled` boolean
      - `sickTimeRuleId` integer
      - `sickTimeRuleName` string, nullable
      - `sickTimeAccrualType` integer
      - `sickHoursAccruedAtBeginningOfYear` number, float
      - `sickTimeYearBeginsOn` string, date-time, nullable
      - `startDateAccuringSickTime` string, date-time, nullable
      - `sickTimeEligibilityBasedOn` integer, nullable
      - `startDateSickTimeUsage` string, date-time, nullable
      - `sickTimeMinHoursWorkForEligibility` number, float
      - `sickTimeEligibilityConstraints` integer
      - `sickTimeResetBalanceAtRenewal` boolean
      - `sickTimeMaxTotalHours` number, float
      - `sickTimeMaxHoursAccruedPerYear` number, float
      - `sickTimeMaxHoursUsedPerYear` number, float
      - `sickTimeMaxHoursCarriedForward` number, float
      - `sickTimeMinimumHoursPerUse` number, float
      - `isUpdateForContractor` boolean
    - `userVacationBenefits` BilfloModelsUsersUserVacationBenefits
      - `userId` integer
      - `isVacationTimeEnabled` boolean
      - `vacationTimeRuleId` integer
      - `vacationTimeRuleName` string, nullable
      - `vacationAccrualType` integer
      - `vacationTimeAccruedAtBeginningOfYear` number, float
      - `vacationTimeYearBeginsOn` string, date-time, nullable
      - `vacationTimeEligibilityBasedOn` integer
      - `startDateVacationTimeUsage` string, date-time, nullable
      - `vacationTimeMinHoursWorkForEligibility` number, float
      - `vacationTimeEligibilityConstraints` integer
      - `vacationTimeResetBalanceAtRenewal` boolean
      - `vacationTimeMaxTotalHours` number, float
      - `vacationTimeMaxHoursAccruedPerYear` number, float
      - `vacationTimeMaxHoursUsedPerYear` number, float
      - `vacationTimeMaxHoursCarriedForward` number, float
      - `vacationTimeMinimumHoursPerUse` number, float
    - `userHealthBenefits` BilfloModelsUsersUserHealthBenefits
      - `userId` integer
      - `isHealthInsuranceEnabled` boolean
      - `healthInsuranceEligibilityDate` string, date-time, nullable
      - `healthInsuranceTerminationDate` string, date-time, nullable
      - `healthInsuranceWaiveDate` string, date-time, nullable
      - `offerOfCoverage` string, nullable
      - `employerMonthlyCost` number, double
      - `employeeMonthlyCost` number, double
      - `renewalDate` string, date-time, nullable
      - `isUpdateForContractor` boolean

---

[API](https://skmtc.net/bilflo/apis/bilflo-api.md) · [All operations](https://skmtc.net/bilflo/apis/bilflo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilflo/bilflo-api/versions/bcdbca776df0/schema)
