# List monthly deltas of a meter

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /meters/{meterIdentification}/deltas:
    get:
      summary: List monthly deltas of a meter
      deprecated: false
      description: >-
        This action allows to list monthly deltas of a single 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 `meter_deltas`.


        By default only deltas for active meter could be fetched. To get deltas
        for deactivated meters inlude param `deactivated=true`.
      operationId: List monthly deltas of a meter
      tags:
        - Deltas
        - Deltas
      parameters:
        - name: meterIdentification
          in: path
          description: >-
            See [meter
            identification](https://apidocs.enectiva.cz/introduction-1363538m0.md#meter-identification)
          required: true
          example: '{{meterIdentification}}'
          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 `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: deactivated
          in: query
          description: Switches the scope to deactivated meters
          required: false
          schema:
            type: boolean
        - 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: m_7955_month_201801010000
                    attributes:
                      time: '2018-01-01T00:00:00.000'
                      value: 101.922047999983
                      unit: m³
                    type: meter_deltas
                  - id: m_7955_month_201802010000
                    attributes:
                      time: '2018-02-01T00:00:00.000'
                      value: 92.0586239999852
                      unit: m³
                    type: meter_deltas
                  - id: m_7955_month_201803010000
                    attributes:
                      time: '2018-03-01T00:00:00.000'
                      value: 101.785055999983
                      unit: m³
                    type: meter_deltas
          headers: {}
          x-apidog-name: OK
        '400':
          description: Bad Request
          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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: >-
                          Sort option `meter_deltas.unsupported_field` is not
                          supported
                        status: '400'
                        title: Bad Request
              examples:
                '2':
                  summary: Unsupported sort option
                  value:
                    errors:
                      - status: '400'
                        title: Bad Request
                        detail: >-
                          Sort option `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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The provided token has expired
                        status: '401'
                        title: Unauthorized
              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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The access token does not have `readings` scope
                        status: '403'
                        title: Forbidden
              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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - status: '404'
                        title: Not Found
              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
                    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
              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
        '409':
          description: Conflict
          content:
            application/vnd.api+json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          type: string
                        meta:
                          properties:
                            conflicting_resources:
                              items:
                                properties:
                                  href:
                                    type: string
                                required:
                                  - href
                                type: object
                                x-apidog-orders:
                                  - href
                              type: array
                          type: object
                          x-apidog-orders:
                            - conflicting_resources
                        status:
                          type: string
                        title:
                          type: string
                      type: object
                      x-apidog-orders:
                        - detail
                        - meta
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: >-
                          Multiple meters found with external_id 'METER_001'.
                          Use Enectiva ID instead.
                        meta:
                          conflicting_resources:
                            - href: https://api.enectiva.cz/meters/123/deltas
                            - href: https://api.enectiva.cz/meters/456/deltas
                        status: '409'
                        title: Conflict
              example:
                errors:
                  - detail: >-
                      Multiple meters found with external_id 'METER_001'. Use
                      Enectiva ID instead.
                    meta:
                      conflicting_resources:
                        - href: https://api.enectiva.cz/meters/123/deltas
                        - href: https://api.enectiva.cz/meters/456/deltas
                    status: '409'
                    title: Conflict
          headers: {}
          x-apidog-name: Conflict
        '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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - status: '429'
                        title: Too Many Requests
              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
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: Something went wrong
                        status: '500'
                        title: Internal Server Error
              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: qgMS9P4AVipsbiUQxwLZw
                schemeIds:
                  - Access token
            required: true
            use:
              id: qgMS9P4AVipsbiUQxwLZw
            scopes:
              qgMS9P4AVipsbiUQxwLZw: {}
      x-apidog-folder: Deltas
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1003855/apis/api-19188094-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: []

```