List customer filter options
Returns one page of the account's customers (by company name) as filter options, optionally narrowed by search text.
Returns every customer whose status is shown in the customer list (status system type 1 = customers, or 3 = customers and suppliers; supplier-only and lead statuses are excluded), ordered by company name. Search text matches the company name, the nickname or the customer number. NOT scoped to the caller: unlike the project dropdown, no customer privilege is applied. Unlike the other dropdowns, skip and take are optional (defaults 0 / 50).
Not for:
- Reading customers —
GET /v1/customeror the CRM search operations
Behaviour:
- Idempotent.
- Safe to retry.
- Changes are visible to the next read immediately.
Call first: GET /v2/filters/list/{pageIdentifier}
Next: GET /v2/filters/project/content
See also: GET /v1/customer
Not yet documented: examples.
curl -X GET "https://app3.timelog.com/your-account/api/v2/filters/customer/content?pageIdentifier=Home&searchText=example_string&skip=0&take=50" \
-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/customer/content?pageIdentifier=Home&searchText=example_string&skip=0&take=50"
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/customer/content?pageIdentifier=Home&searchText=example_string&skip=0&take=50", {
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/customer/content?pageIdentifier=Home&searchText=example_string&skip=0&take=50", 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/customer/content?pageIdentifier=Home&searchText=example_string&skip=0&take=50')
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/customer/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.
Keeps customers whose company name, nickname or customer number contains the text (LIKE '%text%'). Omitted / null = all.
Filters on customer company name, nickname or customer number (contains).
Rows to skip.
Rows to return; no upper bound.
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_ProjectsReportEnhancedSystemAdministrationPlatformPaymentFormPlatformSignupStepsSystemAdministrationPlatformLicenceOverviewSystemAdministrationPlatformInvoiceOverviewSystemAdministrationPlatformActionLogSalarySpecificationReportSystemAdministrationPlatformAccountSpecificationsSystemAdministrationPlatformAccountSettingsSystemAdministrationPlatformInvoiceInformationCashFlowReportFortnoxExportToCronaLonProjectTemplateSyncChangesToLinkedProjectsReportPlatformSignupSalaryManagementOverviewSalaryManagementNewAdjustmentSystemAdministrationEmployeeSalaryGroupSalaryAccountSpecificationSystemAdministrationEmployeeSalaryAccountTypeSystemAdministrationEmployeeAbsenceCodesSystemAdministrationEmployeeAbsenceCodeTypeSystemAdministrationInvoiceProductNumberDimensionMappingSystemAdministrationEmployeeSalaryAccountApproveProjectTimeReportsTransferSalaryFileDownloadTransferEmployeeSalarySalaryPeriodsSystemAdministrationEmployeeSalaryPeriodsSalaryTransferCheckSystemAdministrationPlatformCustomerSystemOwnerGDPRDataSearchReportProjectPlanAmountAddSalesShareDetailedMileageReimbursementReportExtranetLoginExtranetMainExtranetProjectOverviewExtranetTimeRegistrationsExtranetInvoicesExtranetStatusReportsModalWeeklyTimesheetAddProjectTasksModalWeeklyTimesheetNewSubTaskModalDetailedTimesheetNewSubTaskModalDebtorListDrillDownModalCrmImportCustomersModalCrmSendEmailModalCrmCreateInstallmentsModalProjectSaveAsTemplateModalProjectSendEmailModalProjectNewBaselineModalProjectCalculatorModalProjectDrillDownModalProjectAddResourceToTaskModalProjectAddResourcesToTaskModalProjectAddOneResourceModalProjectAdjustTimePlanModalProjectMoveTaskModalProjectUpdateProjectDatesModalProjectMoveAllocationModalProjectNewHourlyRateModalProjectAddMultipleInstallmentsModalResourcePlannerAddToTaskModalResourcePlannerSetWorkloadModalResourcePlannerRemoveBookingsModalCvAddLanguageModalCvAddCompetencesModalCvAddEducationModalCvAddCourseModalCvAddProjectModalCvActivityModalReportWorkloadAddTasksModalReportRedistributionOfTimeModalHourlyRateNewPriceListModalHourlyRateNewCustomerPriceListModalHourlyRateAdjustPriceGroupsModalAccountingPeriodAddNewModalSalaryCopyGroupModalRedistributionOfTimeSplitterModalCrmImportCustomersStepTwoModalCrmImportCustomersStepThreeModalCrmImportCustomersStepFourModalCrmImportCustomersStepFiveProjectInvoiceSettingsModalCreateContractModelModalProjectAddResourceToMultipleMilestonesModalProjectCopyTasksAndMilestonesInvoiceExportFileListSystemAdministrationGeneralSettingLegalEntitySystemAdministrationBasicPlusFeatureSettingAdvancedResourcePlannerProjectManagerOverviewSalesBudgetGenericBudgetValuesSalesReportContributionRatioReportEmployeeCapacityResourceManagementReportAbsenceCalendarCorporateHolidayCalendarMilestonesReportNewDebtorListInvoiceNewDebtorListVoucherSalaryAccountBalanceSectionSalaryFlexAccountSpecificationSystemAdministrationGeneralSettingPersonalDataProtectionSalaryAccountSpecificationAllModalDeleteProjectNavBarExportReportNitroSAPExportEmployeeExpenseEditEmployeeExpenseEmployeeExpenseChangeCurrencyModalExpenseVisualizePicturesModalModalDeleteExpenseProjectExpenseChangeCurrencyModalAgentOverviewReportTransferEmployeeExpenseProjectAllExpensesImportProjectExpensesAbsenceAnalysisReportSystemAdministrationGeneralSettingSystemStartDateAbsenceAnalysisReportDrillDownExpenseOverviewReportModalMilestoneChangeOwnerIntercompanyInvoiceIntercompanyProjectProfitabilityReportCreateProjectFromTemplateMileageRegistrationEditMileageRegistrationModalDeleteMileageRegistrationProjectRecurringProductSaleIndexationRecurringContractsAndProductsMilestoneInlineEditSystemAdministrationRegistrationCarsIndexationOfHourlyRateBaseIndexationOfHourlyRateByPercentageIndexationOfPriceListsImportDataFileQualityAssuranceReportSystemAdministrationEmployeeSalaryRuleNewResourcePlannerSystemAdministrationResourceManagementSettingModalImportPublicHolidayHistoricalIndexedHourlyRatesDataExtractionAbsenceExpenseDownloadAttachmentsSystemAdministrationOneClickInvoicingInvoiceTemplateIntegrationFortnoxAddNewProcessingSystemAdministrationPMContractTypesAssignCustomersToMCPContractModalLinkCustomerWithIntegrationModalLinkContactWithIntegrationDesignSevenFrontPageDesignSevenReportsSystemAdministrationIntegrationSharePointCallbackSystemAdministrationIntegrationSharePointConnectRedirectPiccaNavRevenueExportDesignSevenSearchProjectDesignSevenEditEmployeeCompetenceDesignSevenMoveHoursRevenueForecastingReportProjectPortfolioOverviewWidgetOverdueInvoicesWidgetPlannedAbsenceWidgetInvoicedPerMonthWidgetBudgetRemainingWidgetProjectEconomyHealthWidgetAverageHourlyRateWidgetTimeTrackingDelayWidgetVacationCalculationWidgetHourKPIWidgetHourKPIWithBARWidgetHourKPIHoursOnlyWidgetBillablePercentageWidgetExternalPercentageWidgetPersonalPlanSystemAdministrationAccountingPeriodPhoenixSystemAdministrationIntercompanyExchangeRateSettingMercuriExportOfMonthlyProjectFiguresReportMercuriExportOfEmployeeFiguresReportPhoenixProjectManagementPhoenixDashboardsOverviewPhoenixDashboardsViewNotSpecifiedKeeps customers whose company name, nickname or customer number contains the text (LIKE '%text%'). Omitted / null = all.
Filters on customer company name, nickname or customer number (contains).
Rows to skip.
Rows to return; no upper bound.
Responses
Omitted (not []) when the list is empty.