Eliq

Eliq Location home profile API

The Location home profile API from Eliq — 1 operation(s) for location home profile.

GitHub OpenAPI

Operations 4

GET /locations/{locationId}/homeprofile Get a location home profile #
PUT /locations/{locationId}/homeprofile Create a home profile for location #
DELETE /locations/{locationId}/homeprofile Delete all location home profile elements #
POST /locations/{locationId}/homeprofile Update a property of location home profile #

Documentation

📖
Documentation
https://developer.eliq.com/api-reference
📖
APIReference
https://developer.eliq.com/api-reference/auth-api
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/authentication/eliq-authentication.yml
📖
Documentation
https://developer.eliq.com/doc/eliq-apis
📖
APIReference
https://developer.eliq.com/api-reference/data-mgmt-api
📖
Documentation
https://developer.eliq.com/doc/energy-insights-for-businesses
📖
Documentation
https://developer.eliq.com/doc/device-specific-energy-insights
📖
APIReference
https://developer.eliq.com/api-reference/insights-api
📖
APIReference
https://developer.eliq.com/api-reference/intelligence-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/openapi/eliq-location-home-profile-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://developer.eliq.com
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/scopes/eliq-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/errors/eliq-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/data-model/eliq-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/asyncapi/eliq-webhooks.yml
🔗
Components
https://raw.githubusercontent.com/api-evangelist/eliq/refs/heads/main/components/eliq-components.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/eliq-location-home-profile-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

eliq-location-home-profile-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Eliq Data Management Location home profile API
  description: '# API Reference


    The Eliq data management API is organized around REST.'
  contact:
    name: Support
    email: support_b2b@eliq.com
  version: 1.5.2
tags:
- name: Location home profile
paths:
  /locations/{locationId}/homeprofile:
    get:
      tags:
      - Location home profile
      summary: Get a location home profile
      operationId: get-locations-locationId-homeprofile
      parameters:
      - name: locationId
        in: path
        description: Unique identifier of location
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HomeProfileProperty'
              examples:
                Location home profile:
                  value:
                  - key: house_type
                    value: house
                    value_type: String
                  - key: heating_type_primary
                    value: district_heating
                    value_type: String
                  - key: rooms
                    value: 2
                    value_type: Int64
                Location home profile not created:
                  value: []
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Parameter 'locationId' must not be null or empty:
                  value:
                    code: LOCATION_ID_MISSING
                    description: Parameter 'locationId' must not be null or empty
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Missing value:
                  value:
                    code: LOCATION_NOT_FOUND
                    description: Location with given id could not be found
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Internal server error. If problem remains, please contact support:
                  value:
                    code: INTERNAL_ERROR
                    description: Internal server error. If problem remains, please contact support
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
      deprecated: true
    put:
      tags:
      - Location home profile
      summary: Create a home profile for location
      description: 'The home profile will be overwritten with the inputted values. Please make sure to provide the complete home profile before updating.

        Available home profile keys and values can be provided by Eliq, not yet available in the Data Management API. This can also be retrieved in Eliq Insights API'
      operationId: put-locations-locationId-homeprofile
      parameters:
      - name: locationId
        in: path
        description: Unique identifier of location
        required: true
        schema:
          type: string
      requestBody:
        description: Home profile object to create
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/HomeProfileProperty'
            examples:
              Location home profile:
                value:
                - key: house_type
                  value: house
                  value_type: String
                - key: heating_type_primary
                  value: district_heating
                  value_type: String
                - key: rooms
                  value: 2
                  value_type: Int64
              Location home profile not created:
                value: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HomeProfileProperty'
              examples:
                Location home profile:
                  value:
                  - key: house_type
                    value: house
                    value_type: String
                  - key: heating_type_primary
                    value: district_heating
                    value_type: String
                  - key: rooms
                    value: 2
                    value_type: Int64
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HomeProfileProperty'
              examples:
                Location home profile:
                  value:
                  - key: house_type
                    value: house
                    value_type: String
                  - key: heating_type_primary
                    value: district_heating
                    value_type: String
                  - key: rooms
                    value: 2
                    value_type: Int64
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Home profile must not be null:
                  value:
                    code: HOME_PROFILE_MISSING
                    description: Home profile must not be null
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                Input not supported for multiple_select. Only a list of strings is allowed and all selected values must be valid options.:
                  value:
                    code: HOME_PROFILE_VALUE_INVALID
                    description: Input not supported for multiple_select. Only a list of strings is allowed and all selected values must be valid options.
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                Input not supported for single_select. Only a string value is allowed and it must be a valid option:
                  value:
                    code: HOME_PROFILE_VALUE_INVALID
                    description: Input not supported for single_select. Only a string value is allowed and it must be a valid option
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                Input not supported for number. Only a number is allowed and it must fall within the limits.:
                  value:
                    code: HOME_PROFILE_VALUE_INVALID
                    description: Input not supported for number. Only a number is allowed and it must fall within the limits.
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                Data type {unknown_type} does not exist. Only number, single_select and multiple_select is allowed:
                  value:
                    code: HOME_PROFILE_VALUE_INVALID
                    description: Data type {unknown_type} does not exist. Only number, single_select and multiple_select is allowed
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                ? Property value missing for property at index {invalidPropertyIndex} with key '{invalidProperty.Key}', check if all properties has key and value
                : value:
                    code: HOME_PROFILE_VALUE_MISSING
                    description: Property value missing for property at index {invalidPropertyIndex} with key '{invalidProperty.Key}', check if all properties has key and value
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                'No such property found: ''{property.Key}''':
                  value:
                    code: HOME_PROFILE_KEY_INVALID
                    description: 'No such property found: ''{property.Key}'''
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                Property key missing:
                  value:
                    code: HOME_PROFILE_KEY_MISSING
                    description: Property key missing
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
                ? Property key missing for property at index {invalidPropertyIndex} with value '{invalidProperty.Value}', check if all properties has key and value
                : value:
                    code: HOME_PROFILE_KEY_MISSING
                    description: Property key missing for property at index {invalidPropertyIndex} with value '{invalidProperty.Value}', check if all properties has key and value
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Missing value:
                  value:
                    code: LOCATION_NOT_FOUND
                    description: Location with given id could not be found
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Internal server error. If problem remains, please contact support:
                  value:
                    code: INTERNAL_ERROR
                    description: Internal server error. If problem remains, please contact support
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
      deprecated: true
    delete:
      tags:
      - Location home profile
      summary: Delete all location home profile elements
      operationId: delete-locations-locationId-homeprofile
      parameters:
      - name: locationId
        in: path
        description: Unique identifier of location
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NoContentResult'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Home profile must not be null:
                  value:
                    code: LOCATION_ID_MISSING
                    description: Parameter 'locationId' must not be null or empty
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Missing value:
                  value:
                    code: LOCATION_NOT_FOUND
                    description: Location with given id could not be found
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Internal server error. If problem remains, please contact support:
                  value:
                    code: INTERNAL_ERROR
                    description: Internal server error. If problem remains, please contact support
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
      deprecated: true
    post:
      tags:
      - Location home profile
      summary: Update a property of location home profile
      operationId: post-locations-locationId-homeprofile
      parameters:
      - name: locationId
        in: path
        description: Unique identifier of location
        required: true
        schema:
          type: string
      requestBody:
        description: Home profile property to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HomeProfileProperty'
      responses:
        '204':
          description: No Content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OkObjectResult'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Home profile must not be null:
                  value:
                    code: LOCATION_ID_MISSING
                    description: Parameter 'locationId' must not be null or empty
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Missing value:
                  value:
                    code: LOCATION_NOT_FOUND
                    description: Location with given id could not be found
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
              examples:
                Internal server error. If problem remains, please contact support:
                  value:
                    code: INTERNAL_ERROR
                    description: Internal server error. If problem remains, please contact support
                    request_id: 65e2ea86-470f-4363-9295-35d6b473981a
      deprecated: true
components:
  schemas:
    IOutputFormatter:
      type: object
    HomeProfileProperty:
      type: object
      properties:
        key:
          type:
          - string
          - 'null'
        value: {}
        value_type: {}
    NoContentResult:
      type: object
      properties:
        statusCode:
          type: integer
          format: int32
    ErrorDetails:
      required:
      - code
      - description
      type: object
      properties:
        code:
          minLength: 1
          type: string
        description:
          minLength: 1
          type: string
        request_id:
          type:
          - string
          - 'null'
    OkObjectResult:
      type: object
      properties:
        value: {}
        formatters:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/IOutputFormatter'
        contentTypes:
          type:
          - array
          - 'null'
          items:
            type: string
        declaredType:
          type:
          - string
          - 'null'
        statusCode:
          type:
          - integer
          - 'null'
          format: int32
x-tagGroups:
- name: Users
  tags:
  - User
- name: Locations
  tags:
  - Location
  - Location profile
  - Location home profile
  - Location price formulas
- name: Meters
  tags:
  - Meter
  - Meter Energy Day
  - Meter Energy High Resolution
  - Meter Energy Reads
  - Meter Energy Period
  - Meter Max Demand
  - Meter Price Formulas
- name: Jobs
  tags:
  - Jobs
- name: Portfolio
  tags:
  - Portfolio Accounts
  - Portfolio Groups
  - Portfolio Locations
  - Portfolio Users
- name: Client details
  tags:
  - Client details