List contact filter options
Returns one page of the customer contact persons that are the contact of at least one project, by name, optionally limited to given customers.
Returns each customer contact person that is set as the contact of at least one project — any project state; no contact or project state filter is applied — once, ordered by "first last" name. customerIds limits the list to contacts of those customers (always inclusive; there is no exclude switch). Search text matches the initials, first name or last name. NOT scoped to the caller: contacts of every customer of the account are returned. Personal data of external people (customer contact names).
Use it to:
- Fill the contact picker, narrowed to the customers chosen in the customer dropdown
Not for:
- Listing or searching contacts — use the contact operations
Behaviour:
- Idempotent.
- Safe to retry.
- Changes are visible to the next read immediately.
Call first: GET /v2/filters/list/{pageIdentifier}, GET /v2/filters/customer/content
Not yet documented: examples; request → query params → multiple → max items.
curl -X GET "https://app3.timelog.com/your-account/api/v2/filters/contact/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&customerIds=example_string" \
-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/contact/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&customerIds=example_string"
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/contact/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&customerIds=example_string", {
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/contact/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&customerIds=example_string", 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/contact/content?pageIdentifier=Home&skip=42&take=42&searchText=example_string&customerIds=example_string')
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/contact/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 contacts whose initials, first name or last name contain the text (LIKE '%text%'). Omitted / null = all.
Filters on contact initials, first name or last name (contains).
Customer IDs (from GET /v2/filters/customer/content). Keeps only contacts of these customers; empty / omitted = all customers. A non-integer entry gives 500.
Several values: one string, separated by ,.
Filters on contact's customer (customer ID) (in).
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 contacts whose initials, first name or last name contain the text (LIKE '%text%'). Omitted / null = all.
Filters on contact initials, first name or last name (contains).
Customer IDs (from GET /v2/filters/customer/content). Keeps only contacts of these customers; empty / omitted = all customers. A non-integer entry gives 500.
Several values: one string, separated by ,.
Filters on contact's customer (customer ID) (in).
Responses
Omitted (not []) when the list is empty.