# List entities

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /entities:
    get:
      summary: List entities
      deprecated: false
      description: >-
        This action allows to list entities of a specific customer.


        This endpoint is paginated, see [Limit &
        pagination](https://apidocs.enectiva.cz/introduction-1363538m0.md#limit--pagination)
        for details. By default, at most 1000 records are returned.


        The required scope is `entities`.
      operationId: List meters
      tags:
        - Entities from Enectiva
        - Meters from Enectiva
      parameters:
        - 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:
                            id:
                              type: integer
                            name:
                              type: string
                            parent_id:
                              type: integer
                          required:
                            - id
                            - name
                          x-apidog-orders:
                            - id
                            - name
                            - parent_id
                        type:
                          type: string
                      required:
                        - id
                        - attributes
                        - type
                      x-apidog-orders:
                        - id
                        - attributes
                        - type
                required:
                  - data
                x-apidog-orders:
                  - data
              examples:
                '1':
                  summary: With data
                  value:
                    data:
                      - id: '3560'
                        attributes:
                          name: NAME_1
                          parent_id: 3564
                          type_id: 7aa0c676-6321-4874-b6a0-a9bb2bde3e0d
                        type: entities
                      - id: '3562'
                        attributes:
                          name: NAME_2
                          type_id: fe8f4776-c435-4818-8079-9aba8f3bfb45
                        type: entities
                      - id: '14089'
                        attributes:
                          name: NAME_3
                          parent_id: 3562
                          type_id: 7aa0c676-6321-4874-b6a0-a9bb2bde3e0d
                        type: entities
                '2':
                  summary: Empty
                  value:
                    data: []
          headers: {}
          x-apidog-name: OK
        '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:
                        - detail
                        - status
                        - title
                    type: array
                type: object
                x-apidog-orders:
                  - errors
                examples:
                  - errors:
                      - detail: The access token does not have `meters` scope
                        status: '403'
                        title: Forbidden
                required:
                  - errors
              example:
                errors:
                  - detail: The access token does not have `entities` scope
                    status: '403'
                    title: Forbidden
          headers: {}
          x-apidog-name: Forbidden
        '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:
                        - status
                        - title
                    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: Bj_jQV7IXo03VpzrWxrEH
                schemeIds:
                  - Access token
            required: true
            use:
              id: Bj_jQV7IXo03VpzrWxrEH
            scopes:
              Bj_jQV7IXo03VpzrWxrEH: {}
      x-apidog-folder: Entities from Enectiva
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1003855/apis/api-20950408-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: []

```