> ## Documentation Index
> Fetch the complete documentation index at: https://api.tipee.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Enumerate unvalidated

> Lists, for each resource, the timechecks overlapping the date range that are not validated yet. The number of distinct resources multiplied by the number of days in the date range must not exceed 10000.

> [!WARNING]
>
> This endpoint is in preview: it may change without notice until it becomes part of a stable version.


## OpenAPI

````yaml preview post /api/timeclock/timechecks.enumerate-unvalidated
openapi: 3.1.0
info:
  title: tipee
  version: preview
servers: []
security:
  - basicAuth: []
tags:
  - name: Activity
    description: Activity
  - name: Balances
    description: Balances
  - name: Directory
    description: Directory
  - name: Expenses
    description: Expenses
  - name: Schedule
    description: Schedule
  - name: Security
    description: Security
  - name: Timeclock
    description: Timeclock
paths:
  /api/timeclock/timechecks.enumerate-unvalidated:
    post:
      tags:
        - Timeclock
      summary: Enumerate unvalidated
      description: >-
        Lists, for each resource, the timechecks overlapping the date range that
        are not validated yet. The number of distinct resources multiplied by
        the number of days in the date range must not exceed 10000.
      operationId: post_app_ui_api_timeclock_timeclockquery_enumerateunvalidatedtimechecks
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnumerateUnvalidatedTimechecksQuery'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResourceUnvalidatedTimechecksView'
components:
  schemas:
    EnumerateUnvalidatedTimechecksQuery:
      required:
        - resource_ids
        - date_range
      properties:
        resource_ids:
          description: >-
            One answer per resource, in the order of the request, duplicates
            ignored.
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
        date_range:
          $ref: '#/components/schemas/LocalDateInterval'
          description: >-
            An open timecheck counts as ending, and one without a start as
            starting, the maximum timecheck duration configured on the instance
            (24 hours by default) away from its known time. A timecheck lying
            entirely outside the range is not listed, even in the rare case
            where it still changes the balances of the range, such as one
            starting the day before the range, on which an overnight schedule
            crossing its start begins.
      type: object
      additionalProperties: false
    ResourceUnvalidatedTimechecksView:
      required:
        - resource_id
        - unvalidated_timecheck_ids
      properties:
        resource_id:
          $ref: '#/components/schemas/Snowflake'
        unvalidated_timecheck_ids:
          description: >-
            Empty when all the timechecks of the resource are validated over the
            date range. Ordered by start, or by end for a timecheck without a
            start. Redacted when the caller cannot view the timechecks of the
            resource over the date range, or one of those not validated yet:
            whether they are all validated cannot be told then.
          anyOf:
            - $ref: '#/components/schemas/Redacted'
            - type: array
              items:
                $ref: '#/components/schemas/Snowflake'
      type: object
    Snowflake:
      type: string
      format: snowflake
      example: '872815618512410358'
    LocalDateInterval:
      type: string
      format: local-date-interval
      example: 2019-11-11/2019-12-12
    Redacted:
      required:
        - redacted
      properties:
        redacted:
          type: string
          example: forbidden
          enum:
            - forbidden
            - confidential
      type: object
      x-tipee-bindgen-redacted: true

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.