# List data points of a data series

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /data_series/{dataSeriesId}/data_points:
    get:
      summary: List data points of a data series
      deprecated: false
      description: >-
        This action allows to list data points of a single data series. Only
        valid and fully processed data points are included. The values can be
        [sorted](https://apidocs.enectiva.cz/introduction-1363538m0.md#sort-options),
        the default order is chronological.


        The number of returned records is by default limited to 1000, see [Limit
        &
        pagination](https://apidocs.enectiva.cz/introduction-1363538m0.md#limit--pagination)
        for details. If more records satisfy your [temporal
        filter](https://apidocs.enectiva.cz/introduction-1363538m0.md#filters),
        you can either keep the filter and paginate over the result set using
        the `page` parameter, or narrow down the filter with each request.


        The required scope is `data_points`.
      operationId: List data points of a data series
      tags:
        - Data points from Enectiva
        - Data points from Enectiva
      parameters:
        - name: dataSeriesId
          in: path
          description: Enectiva ID of the data series (not the same as import ID)
          required: true
          example: '{{dataSeriesId}}'
          schema:
            type: integer
        - name: filter
          in: query
          description: The filter conditions
          required: false
          schema:
            type: string
        - name: sort
          in: query
          description: >-
            The sort options. Only `data_points.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: page
          in: query
          description: The page number, default is 1
          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: integer
                            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
                x-apidog-orders:
                  - data
                required:
                  - data
              example:
                data:
                  - id: '3141534'
                    attributes:
                      time: '2018-01-01T00:00:00.000Z'
                      value: 61
                      unit: ppm
                    type: data_points
                  - id: '3150804'
                    attributes:
                      time: '2018-12-31T23:59:00.000Z'
                      value: 75
                      unit: ppm
                    type: data_points
                  - id: '3141538'
                    attributes:
                      time: '2019-09-30T12:46:00.000Z'
                      value: 32
                      unit: ppm
                    type: data_points
          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
                      required:
                        - detail
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: >-
                          Sort option `data_points.unsupported_field` is not
                          supported
                        status: '400'
                        title: Bad Request
                required:
                  - errors
              example:
                errors:
                  - detail: >-
                      Sort option `data_points.unsupported_field` is not
                      supported
                    status: '400'
                    title: Bad Request
          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
                        - status
                        - detail
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The access token does not have `data_points` scope
                        status: '403'
                        title: Forbidden
                required:
                  - errors
              example:
                errors:
                  - detail: The access token does not have `data_points` 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:
                        - status
                        - title
                    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:
                        - title
                        - status
                        - detail
                    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:
                        - title
                        - status
                        - detail
                    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:
            required: true
            schemeGroups:
              - id: 3_nJup9MJTUKxuCZiwMw0
                schemeIds:
                  - Access token
            use:
              id: 3_nJup9MJTUKxuCZiwMw0
      x-apidog-folder: Data points from Enectiva
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1003855/apis/api-19188092-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: []

```