---
title: "Advanced note search"
method: POST
path: "/v1/notes/search"
tags: ["Note"]
---

# Advanced note search

`POST /v1/notes/search`

Performs an advanced search across notes using multiple criteria defined in NoteListParams. Supports filtering by task IDs, date range, document ID, and text search. Results can be sorted and paginated. This endpoint is more flexible than the basic list endpoint and allows for complex queries.

## Request body

- NoteListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `startDate` string
  - `endDate` string
  - `taskId` string
  - `documentId` string
  - `organizationId` string
  - `taskIds` string[]
  - `offset` integer

## Response `200`

Search results successfully retrieved

- NoteList
  - `items` NoteDto[]
    - `id` string
    - `user` string
    - `deleted` boolean
    - `lastUpdate` integer
    - `created` integer
    - `text` string
    - `dateTime` string
    - `uri` string
    - `driveId` string
    - `task` TaskDto
      - `id` string
      - `user` string
      - `deleted` boolean
      - `running` boolean
      - `lastUpdate` integer
      - `created` integer
      - `description` string
      - `location` string
      - `locationEnd` string
      - `startDateTime` string
      - `endDateTime` string
      - `feeling` integer
      - `typeId` integer
      - `paid` boolean
      - `billed` boolean
      - `billable` boolean
      - `phoneNumber` string
      - `distance` string, decimal
      - `signature` string
      - `project` ProjectDto
        - `id` string
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `title` string
        - `description` string
        - `employer` string
        - `office` string
        - `color` integer
        - `taskDefaultBillable` boolean
        - `archived` boolean
        - `salaryVisibility` integer
        - `salary` string, decimal
        - `team` TeamDto
          - `id` string
          - `organization` OrganizationDto
            - `id` string
            - `name` string
            - `description` string
            - `image` string
            - `color` integer
            - `subscription` CustomerSubscriptionDto
              - …
            - `user` string
            - `aiChatEnabled` boolean
            - `lastUpdate` integer
            - `created` integer
            - `deleted` boolean
            - `permission` OrganizationPermissionDto
              - …
          - `organizationId` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `projectSalaryVisibility` integer
          - `user` string
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` TeamPermissionDto
            - `role` string
            - `owner` boolean
            - `manager` boolean
            - `member` boolean
            - `managerOrOwner` boolean
          - `projects` integer
          - `members` integer
          - `projectSalaryVisible` boolean
        - `permission` ProjectPermissionDto
          - `role` string
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
          - `managerOrOwner` boolean
        - `duration` integer
        - `durationBreak` integer
        - `salaryTotal` string, decimal
        - `salaryBreak` string, decimal
        - `expenses` string, decimal
        - `expensesPaid` string, decimal
        - `mileage` string, decimal
        - `todoEstimatedDuration` integer
        - `todoTrackedDuration` integer
        - `todoCount` integer
        - `titleAndClient` string
        - `salaryVisible` boolean
      - `todo` ToDoDto
        - `id` string
        - `user` string
        - `deleted` boolean
        - `lastUpdate` integer
        - `created` integer
        - `project` ProjectDto
          - `id` string
          - `user` string
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `title` string
          - `description` string
          - `employer` string
          - `office` string
          - `color` integer
          - `taskDefaultBillable` boolean
          - `archived` boolean
          - `salaryVisibility` integer
          - `salary` string, decimal
          - `team` TeamDto
            - `id` string
            - `organization` OrganizationDto
              - …
            - `organizationId` string
            - `name` string
            - `description` string
            - `image` string
            - `color` integer
            - `projectSalaryVisibility` integer
            - `user` string
            - `lastUpdate` integer
            - `created` integer
            - `deleted` boolean
            - `permission` TeamPermissionDto
              - …
            - `projects` integer
            - `members` integer
            - `projectSalaryVisible` boolean
          - `permission` ProjectPermissionDto
            - `role` string
            - `owner` boolean
            - `manager` boolean
            - `member` boolean
            - `managerOrOwner` boolean
          - `duration` integer
          - `durationBreak` integer
          - `salaryTotal` string, decimal
          - `salaryBreak` string, decimal
          - `expenses` string, decimal
          - `expensesPaid` string, decimal
          - `mileage` string, decimal
          - `todoEstimatedDuration` integer
          - `todoTrackedDuration` integer
          - `todoCount` integer
          - `titleAndClient` string
          - `salaryVisible` boolean
        - `name` string
        - `description` string
        - `status` integer
        - `dueDate` string
        - `assignedUsers` string
        - `assignedMembers` Member[]
          - `uid` string
          - `firstname` string
          - `lastname` string
          - `email` string
          - `employeeId` string
          - `imageUrl` string
          - `deleted` boolean
          - `activity` Activity
            - `projectId` string
            - `projectTitle` string
            - `projectColor` integer
            - `taskId` string
            - `startDateTime` string
            - `endDateTime` string
            - `location` string
            - `running` boolean
          - `displayName` string
          - `initials` string
        - `estimatedHours` integer
        - `estimatedMinutes` integer
        - `duration` integer
        - `durationBreak` integer
        - `salaryTotal` string, decimal
        - `salaryBreak` string, decimal
        - `expenses` string, decimal
        - `expensesPaid` string, decimal
        - `mileage` string, decimal
        - `progress` number, double
      - `rate` RateDto
        - `id` string
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `title` string
        - `factor` string, decimal
        - `extra` string, decimal
        - `enabled` boolean
        - `archived` boolean
        - `team` TeamDto
          - `id` string
          - `organization` OrganizationDto
            - `id` string
            - `name` string
            - `description` string
            - `image` string
            - `color` integer
            - `subscription` CustomerSubscriptionDto
              - …
            - `user` string
            - `aiChatEnabled` boolean
            - `lastUpdate` integer
            - `created` integer
            - `deleted` boolean
            - `permission` OrganizationPermissionDto
              - …
          - `organizationId` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `projectSalaryVisibility` integer
          - `user` string
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` TeamPermissionDto
            - `role` string
            - `owner` boolean
            - `manager` boolean
            - `member` boolean
            - `managerOrOwner` boolean
          - `projects` integer
          - `members` integer
          - `projectSalaryVisible` boolean
      - `member` Member
        - `uid` string
        - `firstname` string
        - `lastname` string
        - `email` string
        - `employeeId` string
        - `imageUrl` string
        - `deleted` boolean
        - `activity` Activity
          - `projectId` string
          - `projectTitle` string
          - `projectColor` integer
          - `taskId` string
          - `startDateTime` string
          - `endDateTime` string
          - `location` string
          - `running` boolean
        - `displayName` string
        - `initials` string
      - `invoiceId` string
      - `tags` TagDto[]
        - `id` string
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `name` string
        - `color` integer
        - `archived` boolean
        - `team` TeamDto
          - `id` string
          - `organization` OrganizationDto
            - `id` string
            - `name` string
            - `description` string
            - `image` string
            - `color` integer
            - `subscription` CustomerSubscriptionDto
              - …
            - `user` string
            - `aiChatEnabled` boolean
            - `lastUpdate` integer
            - `created` integer
            - `deleted` boolean
            - `permission` OrganizationPermissionDto
              - …
          - `organizationId` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `projectSalaryVisibility` integer
          - `user` string
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` TeamPermissionDto
            - `role` string
            - `owner` boolean
            - `manager` boolean
            - `member` boolean
            - `managerOrOwner` boolean
          - `projects` integer
          - `members` integer
          - `projectSalaryVisible` boolean
        - `totalTime` integer
      - `pauses` PauseDto[]
        - `id` string
        - `user` string
        - `deleted` boolean
        - `running` boolean
        - `lastUpdate` integer
        - `created` integer
        - `description` string
        - `startDateTime` string
        - `endDateTime` string
        - `task` TaskDto — recursive
        - `member` Member
          - `uid` string
          - `firstname` string
          - `lastname` string
          - `email` string
          - `employeeId` string
          - `imageUrl` string
          - `deleted` boolean
          - `activity` Activity
            - `projectId` string
            - `projectTitle` string
            - `projectColor` integer
            - `taskId` string
            - `startDateTime` string
            - `endDateTime` string
            - `location` string
            - `running` boolean
          - `displayName` string
          - `initials` string
      - `expenses` ExpenseDto[]
        - `id` string
        - `user` string
        - `deleted` boolean
        - `lastUpdate` integer
        - `created` integer
        - `description` string
        - `dateTime` string
        - `amount` string, decimal
        - `refunded` boolean
        - `fileUri` string
        - `fileName` string
        - `task` TaskDto — recursive
        - `member` Member
          - `uid` string
          - `firstname` string
          - `lastname` string
          - `email` string
          - `employeeId` string
          - `imageUrl` string
          - `deleted` boolean
          - `activity` Activity
            - `projectId` string
            - `projectTitle` string
            - `projectColor` integer
            - `taskId` string
            - `startDateTime` string
            - `endDateTime` string
            - `location` string
            - `running` boolean
          - `displayName` string
          - `initials` string
        - `invoiceId` string
      - `notes` NoteDto[]
      - `duration` integer
      - `durationBreak` integer
      - `salaryTotal` string, decimal
      - `salaryBreak` string, decimal
      - `expensesTotal` string, decimal
      - `expensesPaid` string, decimal
      - `expensesCount` integer
      - `expensesPaidCount` integer
      - `mileage` string, decimal
      - `notesTotal` integer
      - `salaryVisible` boolean
    - `member` Member
      - `uid` string
      - `firstname` string
      - `lastname` string
      - `email` string
      - `employeeId` string
      - `imageUrl` string
      - `deleted` boolean
      - `activity` Activity
        - `projectId` string
        - `projectTitle` string
        - `projectColor` integer
        - `taskId` string
        - `startDateTime` string
        - `endDateTime` string
        - `location` string
        - `running` boolean
      - `displayName` string
      - `initials` string
  - `params` ListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `400` — Invalid search parameters provided
- `401` — Authentication required - User is not authorized to search notes

---

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