> ## 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.

# Show daily summaries

> Retrieves the daily summaries (worked hours, absences, etc.) of the given resources over a date range. Resources the caller is not allowed to see are silently omitted from the response.

<Warning>This route is in preview: it may change without notice until it becomes part of a stable version.</Warning>


## OpenAPI

````yaml preview post /api/balances/resources.show-daily-summaries
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: Schedule
    description: Schedule
  - name: Timeclock
    description: Timeclock
paths:
  /api/balances/resources.show-daily-summaries:
    post:
      tags:
        - Balances
      summary: Show daily summaries
      description: >-
        Retrieves the daily summaries (worked hours, absences, etc.) of the
        given resources over a date range. Resources the caller is not allowed
        to see are silently omitted from the response.
      operationId: >-
        post_app_ui_api_balances_resourcesummaryquery_showresourcesdailysummaries
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShowResourcesDailySummariesQuery'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResourceDailySummaryView'
components:
  schemas:
    ShowResourcesDailySummariesQuery:
      required:
        - resource_ids
        - date_range
      properties:
        resource_ids:
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
        date_range:
          $ref: '#/components/schemas/LocalDateInterval'
        included_balance_ids:
          title: >-
            Snowflakes of the balances whose daily state must be attached to
            each summary line. Resolve<br />them through the
            `/balances/balances.list` endpoint. When omitted, no balance state
            is attached.
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
      type: object
    ResourceDailySummaryView:
      required:
        - resource_id
        - date
        - contract_work_hours
        - bank_holiday_hours
        - reference_work_hours
        - scheduled_hours
        - timechecked_hours
        - presence_hours
        - adjustment_hours
        - on_call_hours
        - compensation_hours
        - absence_hours
      properties:
        resource_id:
          $ref: '#/components/schemas/Snowflake'
        date:
          $ref: '#/components/schemas/LocalDate'
        contract_work_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        bank_holiday_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        reference_work_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        scheduled_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        timechecked_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        presence_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        adjustment_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        on_call_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        compensation_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        absence_hours:
          oneOf:
            - $ref: '#/components/schemas/Duration'
            - type: 'null'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/ResourceDailySummaryBalanceView'
      type: object
    Snowflake:
      type: string
      format: snowflake
      example: '872815618512410358'
    LocalDateInterval:
      type: string
      format: local-date-interval
      example: 2019-11-11/2019-12-12
    LocalDate:
      type: string
      format: local-date
      example: '2019-11-11'
    Duration:
      description: '[ISO 8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations)'
      type: string
      format: duration
      example: PT1H30M20S
    ResourceDailySummaryBalanceView:
      required:
        - balance_id
        - carryover
        - due
        - done
        - adjustments
        - balance
      properties:
        balance_id:
          $ref: '#/components/schemas/Snowflake'
        carryover:
          $ref: '#/components/schemas/BalanceValue'
        due:
          $ref: '#/components/schemas/BalanceValue'
        done:
          $ref: '#/components/schemas/BalanceValue'
        adjustments:
          $ref: '#/components/schemas/BalanceValue'
        balance:
          $ref: '#/components/schemas/BalanceValue'
      type: object
    BalanceValue:
      required:
        - value
        - output_format
        - error
      properties:
        value:
          type:
            - number
            - 'null'
          format: float
        output_format:
          $ref: '#/components/schemas/OutputFormat'
        error:
          type:
            - string
            - 'null'
          default: null
      type: object
    OutputFormat:
      type: string
      example: days
      enum:
        - days
        - hours
        - units

````