# List monthly deltas of a virtual meter

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /virtual_meters/{virtualMeterId}/deltas:
    get:
      summary: List monthly deltas of a virtual meter
      deprecated: false
      description: >-
        This action allows to list monthly deltas of a single virtual meter.
        Values are in the

        default unit of the corresponding energy. The values can

        be
        [sorted](https://apidocs.enectiva.cz/introduction-1363538m0.md#sort-options),
        the default order is chronological.


        The response is limited to 1000 records. If you need more records, you
        can use

        the `filter` query parameter to traverse all the available data (you can
        get

        more details about it in the related section
        [Filters](https://apidocs.enectiva.cz/introduction-1363538m0.md#filters)).


        The time of each record is the first second of the month. The value is a
        delta

        for that whole month (or up to the last valid reading). The time does
        not

        contain offset information and should be interpreted in the time zone of
        the

        meter.


        The required scope is `virtual_meter_deltas`.
      operationId: List monthly deltas of a virtual meter
      tags:
        - Deltas
        - Deltas
      parameters:
        - name: virtualMeterId
          in: path
          description: Enectiva's numeric virtual meter ID
          required: true
          example: '{{virtualMeterId}}'
          schema:
            type: string
        - name: filter
          in: query
          description: The filter conditions
          required: false
          schema:
            type: string
        - name: sort
          in: query
          description: >-
            The sort options. Only `virtual_meter_deltas.time` is supported at
            the moment. See [sort
            options](https://apidocs.enectiva.cz/introduction-1363538m0.md#sort-options)
            for details.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: The number of records to return, default is 1000
          required: false
          schema:
            type: number
        - name: Accept
          in: header
          description: e.g. application/vnd.api+json
          required: true
          example: application/vnd.api+json
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        attributes:
                          type: object
                          properties:
                            time:
                              type: string
                            value:
                              type: number
                            unit:
                              type: string
                          required:
                            - time
                            - value
                            - unit
                          x-apidog-orders:
                            - time
                            - value
                            - unit
                        type:
                          type: string
                      required:
                        - id
                        - attributes
                        - type
                      x-apidog-orders:
                        - id
                        - attributes
                        - type
                required:
                  - data
                x-apidog-orders:
                  - data
              example:
                data:
                  - id: vm_7955_month_201801010000
                    attributes:
                      time: '2018-01-01T00:00:00.000'
                      value: 101.922047999983
                      unit: m³
                    type: virtual_meter_deltas
                  - id: vm_7955_month_201802010000
                    attributes:
                      time: '2018-02-01T00:00:00.000'
                      value: 92.0586239999852
                      unit: m³
                    type: virtual_meter_deltas
                  - id: vm_7955_month_201803010000
                    attributes:
                      time: '2018-03-01T00:00:00.000'
                      value: 101.785055999983
                      unit: m³
                    type: virtual_meter_deltas
          headers: {}
          x-apidog-name: OK
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        detail:
                          type: string
                        status:
                          type: string
                        title:
                          type: string
                      x-apidog-orders:
                        - detail
                        - status
                        - title
                      required:
                        - detail
                        - status
                        - title
                required:
                  - errors
                x-apidog-orders:
                  - errors
              examples:
                '2':
                  summary: Unsupported sort option
                  value:
                    errors:
                      - status: '400'
                        title: Bad Request
                        detail: >-
                          Sort option `virtual_meter_deltas.unsupported_field`
                          is not supported
                '3':
                  summary: Invalid filter condition
                  value:
                    errors:
                      - status: '400'
                        title: Bad Request
                        detail: >-
                          Filter condition `meter_deltas.time>not_a_date_time`
                          is invalid
          headers: {}
          x-apidog-name: Bad Request
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          type: string
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - detail
                        - status
                        - title
                      required:
                        - detail
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The provided token has expired
                        status: '401'
                        title: Unauthorized
                required:
                  - errors
              example:
                errors:
                  - detail: The provided token has expired
                    status: '401'
                    title: Unauthorized
          headers: {}
          x-apidog-name: Unauthorized
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          type: string
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - detail
                        - status
                        - title
                      required:
                        - title
                        - detail
                        - status
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The access token does not have `readings` scope
                        status: '403'
                        title: Forbidden
                required:
                  - errors
              example:
                errors:
                  - detail: The access token does not have `readings` scope
                    status: '403'
                    title: Forbidden
          headers: {}
          x-apidog-name: Forbidden
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - status
                        - title
                      required:
                        - title
                        - status
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - status: '404'
                        title: Not Found
                required:
                  - errors
              example:
                errors:
                  - status: '404'
                    title: Not Found
          headers: {}
          x-apidog-name: Record Not Found
        '406':
          description: Not Acceptable
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          type: string
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - detail
                        - status
                        - title
                      required:
                        - detail
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: >-
                          Unsupported Accept header value in the request. The
                          endpoint expects the request to include header
                          `Accept: application/vnd.api+json`
                        status: '406'
                        title: Not Acceptable
                required:
                  - errors
              example:
                errors:
                  - detail: >-
                      Unsupported Accept header value in the request. The
                      endpoint expects the request to include header `Accept:
                      application/vnd.api+json`
                    status: '406'
                    title: Not Acceptable
          headers: {}
          x-apidog-name: Not Acceptable
        '429':
          description: Too Many Requests
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - status
                        - title
                      required:
                        - title
                        - status
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - status: '429'
                        title: Too Many Requests
                required:
                  - errors
              example:
                errors:
                  - status: '429'
                    title: Too Many Requests
          headers: {}
          x-apidog-name: Too Many Requests
        '500':
          description: Internal Server Error
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          type: string
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - detail
                        - status
                        - title
                      required:
                        - detail
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: Something went wrong
                        status: '500'
                        title: Internal Server Error
                required:
                  - errors
              example:
                errors:
                  - detail: Something went wrong
                    status: '500'
                    title: Internal Server Error
          headers: {}
          x-apidog-name: Server Error
      security:
        - Access token: []
          x-apidog:
            schemeGroups:
              - id: PmIAsRLN2s9vkldaLvdSA
                schemeIds:
                  - Access token
            required: true
            use:
              id: PmIAsRLN2s9vkldaLvdSA
            scopes:
              PmIAsRLN2s9vkldaLvdSA: {}
      x-apidog-folder: Deltas
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1003855/apis/api-19188095-run
components:
  schemas: {}
  securitySchemes:
    Access token:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      x-apidog:
        addTokenTo: header
        headerPrefix: Bearer
    Import token:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      x-apidog:
        addTokenTo: header
        headerPrefix: Bearer
    Login token:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      x-apidog:
        addTokenTo: header
        headerPrefix: Bearer
    Access  or  Import token:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      x-apidog:
        addTokenTo: header
        headerPrefix: Bearer
servers:
  - url: https://api.enectiva.cz
    description: https://api.enectiva.cz
security: []

```