---
title: "Query times"
method: POST
path: "/v6/timeTracking/times/query"
tags: ["Time Tracking - Times"]
---

# Query times

`POST /v6/timeTracking/times/query`

Query time tracking entries for the authenticated user

## Request body

- TimesGetParam
  - `cursor` string, nullable — Cursor from the previous paginated response
  - `limit` integer — Page size, i.e. number of items to return per page
  - `sort` TimesSort — Sort order for the items in the response.
    - `orderBy` 'DATE' | 'DESCRIPTION' — Sort column
    - `direction` 'ASC' | 'DESC' — Sort direction. Defaults to DESC
  - `filter` TimesFilterParam — Filter for items in the response.
    - `description` StringFilter — Name filter
      - `equal` string — Value - returns all records with specified field equal to this value.
      - `notEqual` string — Value - returns all records with specified field not equal to this value.
      - `greaterThan` string — Value - returns all records with specified field greater than to this value.
      - `greaterThanEqual` string — Value - returns all records with specified field greater than or equal to this value.
      - `lessThan` string — Value - returns all records with specified field less than to this value.
      - `lessThanEqual` string — Value - returns all records with specified field less than or equal to this value.
      - `contain` string — Value - returns all records with specified field containing this value.
    - `status` TimeStatusListFilter — Status filter
      - `in` string[]
      - `notIn` string[]
      - `equal` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `notEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `greaterThan` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `greaterThanEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `lessThan` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `lessThanEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'

## Response `200`

Success

- PaginatedResponseTimeGetDto
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` TimeGetDto[] — The data generated by the action performed.
    - `id` string, required — Id of the time entry
    - `date` string, date, required — Date of the time entry
    - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the time entry
    - `duration` integer, required — Duration of the time entry in milliseconds
    - `task` TaskExpanded, nullable, required — Task associated with this time entry
      - `id` string, required — Id of the task
      - `description` string, nullable, required — Description of the task
    - `description` string, nullable, required — Description of the time entry
    - `notes` string, nullable, required — Notes for the time entry
    - `invoice` InvoiceExpanded, nullable, required — Invoice associated with this time entry
      - `id` string, required — Id of the invoice
      - `name` string — Name of the invoice
      - `date` string, date — Date of the invoice
      - `lineItems` InvoiceLineItem[]
        - `id` string — Id of the invoice line item
        - `amount` integer — Total amount of the invoice line item (in cents)
    - `customer` CustomerExpanded, nullable, required — Customer associated with this time entry
      - `id` string, required — Id of the customer
      - `name` string — Name of the customer
      - `email` string — Email of the customer
    - `dimensionValues` DimensionValueExpanded[], required
      - `id` string, required — Id of the dimension value
      - `dimension` DimensionExpanded — Dimension for this dimension value
        - `id` string, required — Id of the dimension
        - `name` string — Name of the dimension
        - `requiredness` 'REQUIRED' | 'NOT_REQUIRED' — Requiredness of the dimension
      - `name` string — Name of the dimension value
      - `child` ChildDimensionValue — Child dimension value, if applicable
        - `id` string, required — Id of the dimension value
        - `dimension` DimensionExpanded — Dimension for this dimension value
          - `id` string, required — Id of the dimension
          - `name` string — Name of the dimension
          - `requiredness` 'REQUIRED' | 'NOT_REQUIRED' — Requiredness of the dimension
        - `name` string — Name of the dimension value
        - `child` ChildDimensionValue — recursive
    - `employee` EmployeeExpanded, nullable, required — Employee associated with this time entry
      - `id` string, required — Id of the employee
      - `firstName` string, required — First name of the employee
      - `lastName` string, required — Last name of the employee
      - `email` string, nullable, required — Email of the employee
    - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
      - `empty` boolean
      - `array` boolean
      - `null` boolean
      - `object` boolean
      - `float` boolean
      - `string` boolean
      - `number` boolean
      - `missingNode` boolean
      - `valueNode` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `pojo` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `double` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `boolean` boolean
      - `binary` boolean
      - `container` boolean
      - `embeddedValue` boolean
  - `cursor` ResponseCursor — Cursor to be used in your subsequent paginated request. Only populated if there are more pages available.
    - `after` string — After cursor - Fetches entities after this cursor. Useful for paging forwards.
    - `before` string — Before cursor - Fetches entities before this cursor. Useful for paging backwards.

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

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