List employee filter options
Returns one page of the account's active users, by name, as filter options, optionally narrowed by search text and by selected employee types, departments, legal entities and approval managers.
Returns every active user of type 0, ordered by DisplayText "First Last (INITIALS)". Search text matches the first name, the last name or the initials separately (a "first last" string does not match). NOT scoped to the caller: every active user is offered. Value is the USER ID, not the employee ID used by the project-manager / account-manager dropdowns. Personal data (names, initials).
Not for:
- Listing employees or users with their details — use the employee / user operations
Rules across fields:
- R1: Each is...Inclusive flag only has an effect when its ID list is non-empty.
- R2: All supplied ID-list restrictions apply together (AND).
Behaviour:
- Idempotent.
- Safe to retry.
- Changes are visible to the next read immediately.
Call first: GET /v2/filters/list/{pageIdentifier}, GET /v2/filters/employee-type/content, GET /v2/filters/employee-department/content, GET /v2/filters/legal-entity-employee/content, GET /v2/filters/approval-manager/content
See also: GET /v1/user
Not yet documented: examples; purpose → description; request → query params.
curl -X GET "https://app3.timelog.com/your-account/api/v2/filters/employee/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&employeeTypeIds=example_string&isEmployeeTypeInclusive=true&employeeDepartmentIds=example_string&isEmployeeDepartmentInclusive=true&legalEntityEmployeeIds=example_string&isLegalEntityEmployeeInclusive=true&approvalManagerIds=example_string&isApprovalManagerInclusive=true" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://app3.timelog.com/your-account/api/v2/filters/employee/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&employeeTypeIds=example_string&isEmployeeTypeInclusive=true&employeeDepartmentIds=example_string&isEmployeeDepartmentInclusive=true&legalEntityEmployeeIds=example_string&isLegalEntityEmployeeInclusive=true&approvalManagerIds=example_string&isApprovalManagerInclusive=true"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://app3.timelog.com/your-account/api/v2/filters/employee/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&employeeTypeIds=example_string&isEmployeeTypeInclusive=true&employeeDepartmentIds=example_string&isEmployeeDepartmentInclusive=true&legalEntityEmployeeIds=example_string&isLegalEntityEmployeeInclusive=true&approvalManagerIds=example_string&isApprovalManagerInclusive=true", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://app3.timelog.com/your-account/api/v2/filters/employee/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&employeeTypeIds=example_string&isEmployeeTypeInclusive=true&employeeDepartmentIds=example_string&isEmployeeDepartmentInclusive=true&legalEntityEmployeeIds=example_string&isLegalEntityEmployeeInclusive=true&approvalManagerIds=example_string&isApprovalManagerInclusive=true", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://app3.timelog.com/your-account/api/v2/filters/employee/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&employeeTypeIds=example_string&isEmployeeTypeInclusive=true&employeeDepartmentIds=example_string&isEmployeeDepartmentInclusive=true&legalEntityEmployeeIds=example_string&isLegalEntityEmployeeInclusive=true&approvalManagerIds=example_string&isApprovalManagerInclusive=true')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"Entities": [
{
"Properties": {
"DisplayText": "null",
"Value": "example_string"
},
"Links": [
{
"Href": "example_string",
"Rel": "example_string"
}
],
"Actions": [
{}
]
}
],
"Links": [
{
"Href": "example_string",
"Rel": "example_string"
}
]
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/v2/filters/employee/content
Target server for requests. Edit to use your own host.
OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.
Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.Required for route binding (404 when omitted); otherwise ignored.
Allowed values: see PageIdentifier.
Rows to skip. Required (404 when omitted).
Rows to return. Required (404 when omitted); no upper bound.
Keeps users whose first name, last name or initials contain the text. Omitted / null = no text filter.
Filters on user first name, last name or initials (contains).
Employee type IDs (from GET /v2/filters/employee-type/content).
Several values: one string, separated by ,.
Filters on user profile employee type (employee type ID) (in).
true = keep users of these types; false = drop them. Ignored when employeeTypeIds is empty.
Department IDs (from GET /v2/filters/employee-department/content).
Several values: one string, separated by ,.
Filters on user profile department (department ID) (in).
Include / exclude switch for employeeDepartmentIds.
Legal entity IDs (from GET /v2/filters/legal-entity-employee/content).
Several values: one string, separated by ,.
Filters on user profile legal entity (legal entity ID) (in).
Include / exclude switch for legalEntityEmployeeIds.
User IDs of approval managers (from GET /v2/filters/approval-manager/content).
Several values: one string, separated by ,.
Filters on user profile approval manager (user ID) (in).
true = keep users whose approval manager is one of these. false does NOT drop them: it drops users whose LEGAL ENTITY ID equals one of these IDs.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
Not yet documented: how to obtain a token.
Not yet documented: token lifetime.
Query Parameters
Required for route binding (404 when omitted); otherwise ignored.
Allowed values: see PageIdentifier.
HomeDetailedTimesheetWeeklyTimesheetProjectExpenseTravelExpensesRegistrationEventsImportEmployeeExpensesCRMCustomerCRMContactCRMEventCRMOpportunityCRMRelationCRMCustomerNewCRMContactNewSearchProjectNewProjectNewQuickProjectImportFromMSProjectDebtorListInvoicesDebtorListVouchersSearchInvoiceTransferInvoicesInvoiceNewVoucherNewEmployeesResourcePlannerBookedVsRegisteredApproveTimeReportsApproveExpensesNewEmployeeCVOverviewNewCVSkillMatrixReportsCRMHomeStartCRMPipelineCRMReportCRMJournalCRMLeadInboxProjectSettingProjectTaskPlanViewProjectTaskBudgetViewProjectResourceViewProjectGanttViewProjectResourceGroupProjectPaymentPlanProjectBudgetOverviewProjectDeprecationStatusAmountProjectDeprecationStatusHourProjectInvoiceOverviewProjectDocumentsProjectStatusReportTableViewReportBoxViewExpenseReportSubmitPrintKeyPerformanceIndexProjectPlansProjectAssignmentsWorkloadCustomerSignOffAbsenceSpecificationAbsenceProductivityAbsenceReportFlexBalanceAllEmployeesAbsenceSpecificationAllEmployeesEmployeeOverviewWorkCustomersWorkSingleCustomerEmployeeOverview2HeadCountAccountingProjectsWorkInProgressPaymentPlansOverviewCRMEventNewCRMOpportunityNewBudgetCompanyBudgetEmployeesContributionMarginAccountingMonthlyAccountingCustomersAccountingProjectsRegistrationTypesBalanceProjectBudgetsProjectOverviewAllocatedActualWorkTimeRegistrationsTimeRegistrationsNewActiveProjectTasksBudgetFollowUpMilestonesGanttChartProjectFactorWorkProjectsWorkProjectTypesWorkProjectCategoriesWorkTaskTypesProjectPortfolioProjectCategoriesAnalysisChangeHourlyRatesOnAllocationsAdjustBillableNonBillableRedistributionOfTimeMoveAllocationsDepartmentProjectsEmployeesWorkDepartmentsReportApproveTimeReportsStatusForTimeReportsReportApproveExpensesReportBalanceExpensesTimeRegistrationsDetailedTimeRegistrationsSummarisedTimelogCRMWorkIndustriesPivotReportTimeRegistrationsPerProjectEmployeeContributionAnalysisInvoicingPercentageEmployeeEfficiencyInternalExternalAnalysisEmployeeKeyFiguresEmployeeTimeCustomersAndProjectsEmployeeTimeProjectTypesAndTaskTypesEmployeeTimeHourlyRatesLastTimeRegistrationAccuracyInTimeTrackingDataExtractionProjectsDataExtractionTasksDataExtractionAllocationsDataExtractionInstallmentsDataExtractionProjectBaselineDataExtractionCustomersDataExtractionInvoicesDataExtractionInvoiceLinesDataExtractionExpensesDataExtractionTravelExpensesDataExtractionMileageDataExtractionAbsenceAndSalaryCodesExportProjectsReportImportOfExpensesInvoiceLinesExportExportToKontekPAXmlExportToVismaLonSuperTimesheetEmployeeOverviewTableViewEmployeeOverviewBoxViewSalaryExtractionForLessorLonTimeLogTrackerInstallEditEmployeeCVEventsCustomersAdvanceETCReportSubmitEmployeeCVIntegrationLogWorkEmployeeTypesStatusReportsSystemAdministrationRegistrationTimeRegistrationSettingSystemAdministrationRegistrationExpenseSettingSystemAdministrationEmployeeSettingSystemAdministrationRegistrationAllowanceTypesSystemAdministrationRegistrationPaymentMethodSystemAdministrationRegistrationMileageRatesSystemAdministrationRegistrationExpenseTypesSystemAdministrationApprovalSettingSystemAdministrationCRMSettingSystemAdministrationCRMStandardValuesSystemAdministrationCRMNotificationsSystemAdministrationCRMExtranetSystemAdministrationCRMIndustryCodesSystemAdministrationCRMGroupsSystemAdministrationCRMStatusesSystemAdministrationCRMEventTypesSystemAdministrationCRMRelationsSystemAdministrationCRMBarriersSystemAdministrationCRMOpportunityStatusSystemAdministrationCRMOpportunityTypesSystemAdministrationPMProjectSettingSystemAdministrationPMStandardValuesSystemAdministrationPMProjectInvoicingSystemAdministrationPMNotificationsSystemAdministrationPMProjectTypesSystemAdministrationPMProjectCategoriesSystemAdministrationPMTaskTypesSystemAdministrationPMProjectStagesSystemAdministrationPMProjectTemplatesSystemAdministrationPMETCSettingSystemAdministrationInvoiceSettingSystemAdministrationInvoiceStandardValuesSystemAdministrationInvoiceTemplatesSystemAdministrationInvoiceHourlyRatesSystemAdministrationInvoiceCostPricesSystemAdministrationInvoicePaymentTermsSystemAdministrationInvoiceAccountingPeriodSystemAdministrationInvoiceProductNumberSystemAdministrationInvoiceCurrencySettingSystemAdministrationInvoiceInvoiceLineExportSettingSystemAdministrationInvoiceConfigurationModelOfCalculationSystemAdministrationEmployeePermissionSystemAdministrationEmployeeTypesSystemAdministrationEmployeeNormHoursSystemAdministrationEmployeeHolidayCalendarSystemAdministrationEmployeeSkillSettingSystemAdministrationEmployeeCompetenciesSystemAdministrationReportActivationSystemAdministrationReportAdvancedSettingSystemAdministrationReportKPISettingSystemAdministrationIntegrationAPISettingSystemAdministrationIntegrationSystemIntegrationSystemAdministrationIntegrationStandardFileExportSystemAdministrationIntegrationImportOfStandardFieldSystemAdministrationGeneralSettingDepartmentsSystemAdministrationGeneralSettingNumberSeriesSystemAdministrationGeneralSettingSecurityAccessEditEmployeeEmployeeOverviewBaseShowMyCustomersCRMHomeCompanyCRMHomeEmployeeSystemAdministrationGeneralSettingRootPageSystemAdministrationGeneralSettingLicenseSettingSystemAdministrationEmployeeNotificationPrintJournalChronologicallyEditCustomerSystemAdministrationGeneralSettingFrontPageProjectPlanProgressCRMEditEventExternalTransactionLogSystemAdministrationEmployeeSalaryCodesCRMRelationNewCRMRelationEditCRMOpportunityEditCRMContactEditFrontPageInvoiceEditInvoiceBookedVoucherEditVoucherBookedCreditNoteNewCreditNoteEditCreditNoteBookedReminderNewReminderEditReminderBookedCRMReportLastUpdatedCustomerCRMReportSalesPipelineCRMReportEventOverviewPersonalProfilePersonalPreferenceChangePasswordProjectAddResourceToTasksProjectAddMultipleResourcesToTaskProjectAddOneResourceProjectUpdateProjectStartAndEndDatesTimeRegistrationDrillDownNewHourlyRateProjectAddMultipleInstallmentsErrorListContractOverviewAccessDeniedProjectFactorDetailsExportSDLonSalaryExtractionForHogiaProjectPendingBookingActionTimeReportUserDefinedSystemAdministrationReportProjectFactorSettingProjectOverviewOldProcessSidePanelCustomLinkSidePanelCustomHelpSidePanelSystemAdministrationEmployeeRolesMatrixesEditProjectExpenseEditTravelExpenseCRMSupplierNewSystemAdministrationIntegrationReportingAPISettingSystemAdministrationIntegrationReportingAPILogTestPageReportMVCTestPageReportNetWebFormTestPageReportClassicASPSystemAdministrationGeneralSettingNotificationSettingsNewInvoiceWithProjectNewInvoiceWithCustomerNewInvoiceWithCustomerAndProjectNewVoucherWithProjectNewVoucherWithCustomerNewCreditNoteWithInvoiceNewReminderWithInvoiceReportProjectSumFiguresSalaryExtractionForAccobatInvoiceLinesExportForAccobatReportWorkInProgressUnitsReportAtkiCopyProjectConsultantHoursReportEmployeeHoursReportHempelInvoiceSpecificationReportImportExpensesDevelcoEmployeeOverviewExportEUProjectsReportEmployeeProductivityReportVoucherSystemStatementReportEdlundInvoiceSpecificationReportGlobeteamExportRegisteredTimeReportGlobeteamExportTasksReportAddProjectTemplateIntoExisitingProjectExportNonInvoicedHoursEmployeeOverviewReportAdjustAllocationWithStandardHourlyRatesOneClickInvoicingLogProjectProfitabilityDataImporterInvoiceAccountingPeriodProjectTaskPlanHourDataExtractionProjectContractBaselineInvoice_InvoiceLogInvoiceArchiveSystemAdministrationProductListErrorExpensesBatchAdjustProjectPaymentsSystemAdministrationInvoiceUnitTypeDataExtractionProjectSubContractSystemAdministrationEmployeeCVStatusBasicoDataExtractionForNavTimeTrackingBaseSystemAdministrationPMMilestoneTypesInvoiceLineExportReportExportInvoiceDataReportAnalysisPivotReportEU_ProjectsReportEnhancedSystemAdministrationPlatformPaymentFormPlatformSignupStepsSystemAdministrationPlatformLicenceOverviewSystemAdministrationPlatformInvoiceOverviewSystemAdministrationPlatformActionLogSalarySpecificationReportSystemAdministrationPlatformAccountSpecificationsSystemAdministrationPlatformAccountSettingsSystemAdministrationPlatformInvoiceInformationCashFlowReportFortnoxExportToCronaLonProjectTemplateSyncChangesToLinkedProjectsReportPlatformSignupSalaryManagementOverviewSalaryManagementNewAdjustmentSystemAdministrationEmployeeSalaryGroupSalaryAccountSpecificationSystemAdministrationEmployeeSalaryAccountTypeSystemAdministrationEmployeeAbsenceCodesSystemAdministrationEmployeeAbsenceCodeTypeSystemAdministrationInvoiceProductNumberDimensionMappingSystemAdministrationEmployeeSalaryAccountApproveProjectTimeReportsTransferSalaryFileDownloadTransferEmployeeSalarySalaryPeriodsSystemAdministrationEmployeeSalaryPeriodsSalaryTransferCheckSystemAdministrationPlatformCustomerSystemOwnerGDPRDataSearchReportProjectPlanAmountAddSalesShareDetailedMileageReimbursementReportExtranetLoginExtranetMainExtranetProjectOverviewExtranetTimeRegistrationsExtranetInvoicesExtranetStatusReportsModalWeeklyTimesheetAddProjectTasksModalWeeklyTimesheetNewSubTaskModalDetailedTimesheetNewSubTaskModalDebtorListDrillDownModalCrmImportCustomersModalCrmSendEmailModalCrmCreateInstallmentsModalProjectSaveAsTemplateModalProjectSendEmailModalProjectNewBaselineModalProjectCalculatorModalProjectDrillDownModalProjectAddResourceToTaskModalProjectAddResourcesToTaskModalProjectAddOneResourceModalProjectAdjustTimePlanModalProjectMoveTaskModalProjectUpdateProjectDatesModalProjectMoveAllocationModalProjectNewHourlyRateModalProjectAddMultipleInstallmentsModalResourcePlannerAddToTaskModalResourcePlannerSetWorkloadModalResourcePlannerRemoveBookingsModalCvAddLanguageModalCvAddCompetencesModalCvAddEducationModalCvAddCourseModalCvAddProjectModalCvActivityModalReportWorkloadAddTasksModalReportRedistributionOfTimeModalHourlyRateNewPriceListModalHourlyRateNewCustomerPriceListModalHourlyRateAdjustPriceGroupsModalAccountingPeriodAddNewModalSalaryCopyGroupModalRedistributionOfTimeSplitterModalCrmImportCustomersStepTwoModalCrmImportCustomersStepThreeModalCrmImportCustomersStepFourModalCrmImportCustomersStepFiveProjectInvoiceSettingsModalCreateContractModelModalProjectAddResourceToMultipleMilestonesModalProjectCopyTasksAndMilestonesInvoiceExportFileListSystemAdministrationGeneralSettingLegalEntitySystemAdministrationBasicPlusFeatureSettingAdvancedResourcePlannerProjectManagerOverviewSalesBudgetGenericBudgetValuesSalesReportContributionRatioReportEmployeeCapacityResourceManagementReportAbsenceCalendarCorporateHolidayCalendarMilestonesReportNewDebtorListInvoiceNewDebtorListVoucherSalaryAccountBalanceSectionSalaryFlexAccountSpecificationSystemAdministrationGeneralSettingPersonalDataProtectionSalaryAccountSpecificationAllModalDeleteProjectNavBarExportReportNitroSAPExportEmployeeExpenseEditEmployeeExpenseEmployeeExpenseChangeCurrencyModalExpenseVisualizePicturesModalModalDeleteExpenseProjectExpenseChangeCurrencyModalAgentOverviewReportTransferEmployeeExpenseProjectAllExpensesImportProjectExpensesAbsenceAnalysisReportSystemAdministrationGeneralSettingSystemStartDateAbsenceAnalysisReportDrillDownExpenseOverviewReportModalMilestoneChangeOwnerIntercompanyInvoiceIntercompanyProjectProfitabilityReportCreateProjectFromTemplateMileageRegistrationEditMileageRegistrationModalDeleteMileageRegistrationProjectRecurringProductSaleIndexationRecurringContractsAndProductsMilestoneInlineEditSystemAdministrationRegistrationCarsIndexationOfHourlyRateBaseIndexationOfHourlyRateByPercentageIndexationOfPriceListsImportDataFileQualityAssuranceReportSystemAdministrationEmployeeSalaryRuleNewResourcePlannerSystemAdministrationResourceManagementSettingModalImportPublicHolidayHistoricalIndexedHourlyRatesDataExtractionAbsenceExpenseDownloadAttachmentsSystemAdministrationOneClickInvoicingInvoiceTemplateIntegrationFortnoxAddNewProcessingSystemAdministrationPMContractTypesAssignCustomersToMCPContractModalLinkCustomerWithIntegrationModalLinkContactWithIntegrationDesignSevenFrontPageDesignSevenReportsSystemAdministrationIntegrationSharePointCallbackSystemAdministrationIntegrationSharePointConnectRedirectPiccaNavRevenueExportDesignSevenSearchProjectDesignSevenEditEmployeeCompetenceDesignSevenMoveHoursRevenueForecastingReportProjectPortfolioOverviewWidgetOverdueInvoicesWidgetPlannedAbsenceWidgetInvoicedPerMonthWidgetBudgetRemainingWidgetProjectEconomyHealthWidgetAverageHourlyRateWidgetTimeTrackingDelayWidgetVacationCalculationWidgetHourKPIWidgetHourKPIWithBARWidgetHourKPIHoursOnlyWidgetBillablePercentageWidgetExternalPercentageWidgetPersonalPlanSystemAdministrationAccountingPeriodPhoenixSystemAdministrationIntercompanyExchangeRateSettingMercuriExportOfMonthlyProjectFiguresReportMercuriExportOfEmployeeFiguresReportPhoenixProjectManagementPhoenixDashboardsOverviewPhoenixDashboardsViewNotSpecifiedRows to skip. Required (404 when omitted).
Rows to return. Required (404 when omitted); no upper bound.
Keeps users whose first name, last name or initials contain the text. Omitted / null = no text filter.
Filters on user first name, last name or initials (contains).
Employee type IDs (from GET /v2/filters/employee-type/content).
Several values: one string, separated by ,.
Filters on user profile employee type (employee type ID) (in).
true = keep users of these types; false = drop them. Ignored when employeeTypeIds is empty.
Department IDs (from GET /v2/filters/employee-department/content).
Several values: one string, separated by ,.
Filters on user profile department (department ID) (in).
Include / exclude switch for employeeDepartmentIds.
Legal entity IDs (from GET /v2/filters/legal-entity-employee/content).
Several values: one string, separated by ,.
Filters on user profile legal entity (legal entity ID) (in).
Include / exclude switch for legalEntityEmployeeIds.
User IDs of approval managers (from GET /v2/filters/approval-manager/content).
Several values: one string, separated by ,.
Filters on user profile approval manager (user ID) (in).
true = keep users whose approval manager is one of these. false does NOT drop them: it drops users whose LEGAL ENTITY ID equals one of these IDs.
Responses
Omitted (not []) when the list is empty.