A **Tenant Consumption Link** attributes a year's **Annual Consumption** to a **Tenant**. Links are created and deleted through the API by tenant external id and annual-consumption id (both must belong to the same building).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/alasco-tenant-consumption-links-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: '## Introduction
You can use the Alasco API to integrate your application with Alasco.'
title: ESG Tenant Consumption Links API
version: '1.0'
x-logo:
url: https://assets-global.website-files.com/656ef2eb27ad41897248f866/659eebec190ae7aaf4162f09_Logotype_Alasco_white_RGB%202.png
servers:
- url: https://api.alasco.de/esg/v1
tags:
- description: A **Tenant Consumption Link** attributes a year's **Annual Consumption** to a **Tenant**. Links are created and deleted through the API by tenant external id and annual-consumption id (both must belong to the same building).
name: Tenant Consumption Links
paths:
/tenant-consumption-links/:
delete:
operationId: delete_tenant_consumption_link_tenant_consumption_links__delete
parameters:
- description: External ID of the tenant.
in: query
name: external_tenant_id
required: true
schema:
description: External ID of the tenant.
title: External Tenant Id
type: string
- description: UUID of the annual consumption entry.
in: query
name: annual_consumption_id
required: true
schema:
description: UUID of the annual consumption entry.
format: uuid
title: Annual Consumption Id
type: string
responses:
'204':
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Delete Tenant Consumption Link
tags:
- Tenant Consumption Links
post:
operationId: create_tenant_consumption_link_tenant_consumption_links__post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TenantConsumptionLinkPayload'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/TenantConsumptionLinkResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- API Key: []
- API Token: []
summary: Create Tenant Consumption Link
tags:
- Tenant Consumption Links
components:
schemas:
TenantConsumptionLinkWrite:
properties:
annual_consumption_id:
format: uuid
title: Annual Consumption Id
type: string
external_tenant_id:
title: External Tenant Id
type: string
required:
- external_tenant_id
- annual_consumption_id
title: TenantConsumptionLinkWrite
type: object
ValidationError:
properties:
ctx:
title: Context
type: object
input:
title: Input
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
Links:
properties:
next:
anyOf:
- type: string
- type: 'null'
title: Next
prev:
anyOf:
- type: string
- type: 'null'
title: Prev
required:
- next
- prev
title: Links
type: object
ResourceType:
enum:
- BUILDING
- UTILITY_METER
- UTILITY_METER_IMPORT
- UTILITY_METER_READING
- CONSUMPTION_INTERVAL
- UTILITY_DATA_BATCH_INFO
- AUDIT_LOG
- USER_AUDIT_LOG
- DOCUMENT_EVENT
- FILE
- FILE_EXTERNAL_ID
- FILE_METADATA
- ANALYSIS_RESULT
- TENANT
- TENANT_ATTACHMENT
- CUSTOM_DATA_GROUP_INSTANCE
- ANNUAL_CONSUMPTION
- TENANT_CONSUMPTION_LINK
title: ResourceType
type: string
TenantConsumptionLinkCreatePayloadData:
properties:
attributes:
$ref: '#/components/schemas/TenantConsumptionLinkWrite'
type:
const: TENANT_CONSUMPTION_LINK
title: Type
type: string
required:
- type
- attributes
title: TenantConsumptionLinkCreatePayloadData
type: object
TenantConsumptionLinkResponse:
properties:
data:
$ref: '#/components/schemas/TenantConsumptionLinkData'
errors:
anyOf:
- items:
$ref: '#/components/schemas/Error'
type: array
- type: 'null'
title: Errors
included:
anyOf:
- items:
$ref: '#/components/schemas/BaseDataSchema'
type: array
- type: 'null'
title: Included
links:
anyOf:
- $ref: '#/components/schemas/Links'
- type: 'null'
required:
- data
title: TenantConsumptionLinkResponse
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
BaseDataSchema:
properties:
attributes:
anyOf:
- {}
- type: 'null'
title: Attributes
id:
format: uuid
title: Id
type: string
relationships:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Relationships
type:
$ref: '#/components/schemas/ResourceType'
required:
- id
- type
title: BaseDataSchema
type: object
Error:
properties:
code:
anyOf:
- type: string
- type: 'null'
title: Code
detail:
anyOf:
- type: string
- type: 'null'
title: Detail
source:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Source
status:
anyOf:
- type: string
- type: 'null'
title: Status
title:
anyOf:
- type: string
- type: 'null'
title: Title
title: Error
type: object
TenantConsumptionLinkPayload:
properties:
data:
$ref: '#/components/schemas/TenantConsumptionLinkCreatePayloadData'
required:
- data
title: TenantConsumptionLinkPayload
type: object
TenantConsumptionLinkAttributes:
properties:
annual_consumption_id:
description: '**Annual consumption ID** · **Jahresverbrauch-ID**'
format: uuid
title: Annual Consumption Id
type: string
external_tenant_id:
description: '**External tenant ID** · **Externe Mieter-ID**'
title: External Tenant Id
type: string
required:
- external_tenant_id
- annual_consumption_id
title: TenantConsumptionLinkAttributes
type: object
TenantConsumptionLinkData:
properties:
attributes:
$ref: '#/components/schemas/TenantConsumptionLinkAttributes'
id:
format: uuid
title: Id
type: string
relationships:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Relationships
type:
const: TENANT_CONSUMPTION_LINK
default: TENANT_CONSUMPTION_LINK
title: Type
type: string
required:
- id
- attributes
title: TenantConsumptionLinkData
type: object
securitySchemes:
API_Key:
description: '
The Alasco API uses a combination of API keys and API tokens to authenticate requests. The API key
needs to be sent in a header field called `X-API-KEY`.
'
in: header
name: X-API-KEY
type: apiKey
API_Token:
description: '
In addition to an API key, one has to specify an API token. There can be one or more tokens in use
for the same API key. The token needs to be sent in a header field called `X-API-TOKEN`.
Right now, it''s not possible to create API keys and API tokens from within Alasco.
If you are interested in using the Alasco API, please reach out to the
[support team](mailto:support@alasco.de). They will assist you in generating a key and token pair.
'
in: header
name: X-API-TOKEN
type: apiKey