KPN

KPN Data Consumer API

The DataConsumer API from KPN — 2 operation(s) for dataconsumer.

Documentation GitHub OpenAPI

Operations 2

GET /datashare/v1/{businessUnit}/{label}/dataconsumer/{dataOwnerId}/{productType}/usages Get usages for data consumers #

GET /datashare/v1/{businessUnit}/{label}/dataconsumer/{dataOwnerId}/{productType}/metadata Get metadata of data owner for data consumers #

Documentation

https://developer.kpn.com/products/kpn-number-verify

https://developer.kpn.com/documentation/kpn-number-verify-documentation

https://app.swaggerhub.com/apis-docs/kpn/numberverify-kpn

https://developer.kpn.com/products/kpn-account-takeover-protection

https://developer.kpn.com/documentation/kpn-account-takeover-protection-documentation

https://app.swaggerhub.com/apis-docs/kpn/simswap-kpn

https://developer.kpn.com/products/kpn-match

https://developer.kpn.com/documentation/kpn-match-documentation

https://app.swaggerhub.com/apis-docs/kpn/match-kpn

https://developer.kpn.com/products/kpn-sms-api

https://developer.kpn.com/documentation/kpn-sms-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/sms-kpn

https://app.swaggerhub.com/apis-docs/kpn/sms-inbound

https://developer.kpn.com/products/kpn-mobile-services-management-api

https://developer.kpn.com/documentation/kpn-mobile-services-management-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/mobileservicesmanagement-kpn

https://developer.kpn.com/products/federated-identity-and-access-management

https://developer.kpn.com/documentation/fiam-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/fiam-kpn

https://developer.kpn.com/products/fiam-eneco-data-products

https://developer.kpn.com/documentation/eneco-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/fiam-eneco-data-products

https://developer.kpn.com/products/kpn-disturbance-check-api

https://developer.kpn.com/documentation/kpn-disturbance-check-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/disturbance-check-kpn

https://developer.kpn.com/products/kpn-internet-speed-check-api

https://developer.kpn.com/documentation/kpn-internet-speed-check-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/internet-speed-check-kpn

https://developer.kpn.com/products/kpn-high-level-design-fttx-api

https://developer.kpn.com/documentation/kpn-high-level-design-fttx-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/high-level_design_ftth

https://developer.kpn.com/products/kpn-lora-device-management-api

https://developer.kpn.com/documentation/kpn-lora-device-management-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/lora-device-management-kpn

https://developer.kpn.com/products/kpn-sd-lan-sd-wan-network-view-api

https://developer.kpn.com/documentation/kpn-sd-lan-sd-wan-network-view-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/kpn-sd_lan_sd_wan_network_view_api

https://developer.kpn.com/products/kpn-servicenow-connect-api

https://developer.kpn.com/documentation/kpn-servicenow-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/servicenow-kpn

https://app.swaggerhub.com/apis-docs/kpn/ise-kpn

https://app.swaggerhub.com/apis-docs/kpn/tv-guide-kpn

https://app.swaggerhub.com/apis-docs/kpn/webhook-signing-key-management-kpn

https://app.swaggerhub.com/apis-docs/kpn/webhook-privacy-config-manager

https://app.swaggerhub.com/apis-docs/kpn/wholesale-wba-kpn

https://app.swaggerhub.com/apis-docs/kpn/wholesale-broadband_access_fpi_cip

https://developer.kpn.com/products/pollyhelp-knowledge-management-api

https://developer.kpn.com/documentation/pollyhelp-knowledge-management-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/knowledge-management-polly.help

https://developer.kpn.com/products/xdroid-speech-text-api

https://developer.kpn.com/documentation/xdroid-xdroid-speech-text-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/speech-to-text-xdroid

https://developer.kpn.com/products/parley-secure-messenger-api

https://developer.kpn.com/documentation/parley-chat-and-messaging-api-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/secure-messenger-parley

https://developer.kpn.com/products/social-media-chat-and-messaging

https://developer.kpn.com/documentation/parley-webcare-parley-documentation-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/socialmediawebcare-tracebuzz

https://developer.kpn.com/products/weseedo-weseedo-direct-api

https://developer.kpn.com/documentation/weseedo-weseedo-direct-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/weseedo-direct-weseedo

https://developer.kpn.com/products/weseedo-weseedo-personal-api

https://developer.kpn.com/documentation/weseedo-weseedo-personal-weseedo-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/weseedo-personal-weseedo

https://developer.kpn.com/products/vonage-messages-api

https://developer.kpn.com/documentation/vonage-messages-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/messages-nexmo

https://developer.kpn.com/products/vonage-voice-api

https://developer.kpn.com/documentation/vonage-voice-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/voice-nexmo

https://developer.kpn.com/products/vonage-phone-numbers-api

https://developer.kpn.com/documentation/vonage-phone-numbers-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/phone-numbers-nexmo

https://developer.kpn.com/products/vonage-number-insight-api

https://developer.kpn.com/documentation/vonage-number-insight-api-documentation

https://app.swaggerhub.com/apis-docs/kpn/number-insight-nexmo

https://app.swaggerhub.com/apis-docs/kpn/sms-nexmo

https://app.swaggerhub.com/apis-docs/kpn/verify-nexmo

https://app.swaggerhub.com/apis-docs/kpn/apidaze-voice-voip-innovations

https://app.swaggerhub.com/apis-docs/kpn/registeredemail-registeredemail

Specifications

https://raw.githubusercontent.com/api-evangelist/kpn/refs/heads/main/openapi/kpn-dataconsumer-api-openapi.yml

Other Resources

https://raw.githubusercontent.com/api-evangelist/kpn/refs/heads/main/asyncapi/kpn-webhooks.yml

https://raw.githubusercontent.com/api-evangelist/kpn/refs/heads/main/errors/kpn-sms-error-codes.yml

https://developer.kpn.com/products/kpn-sms-api

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/kpn-dataconsumer-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: FIAM – Eneco Data Products Data Consumer API
  description: Eneco DataShare APIs
  contact:
    name: Eneco Integration Team
    url: https://developer.enecogroup.com
    email: FM_BTO_Integration_Team@eneco.com
  version: 1.0.1
servers:
- url: https://api-acc.enecogroup.com/
- url: https://api.enecogroup.com/
security:
- apikey: []
tags:
- name: DataConsumer
paths:
  /datashare/v1/{businessUnit}/{label}/dataconsumer/{dataOwnerId}/{productType}/usages:
    get:
      tags:
      - DataConsumer
      summary: Get usages for data consumers
      description: Get usages for data consumers by validating contract via KPN FIAM
      operationId: Get usages for data consumers
      parameters:
      - name: businessUnit
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/BusinessUnitBinding'
      - name: label
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/LabelBinding'
      - name: dataOwnerId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: productType
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ProductTypeBinding'
      - name: endDate
        in: query
        explode: false
        schema:
          type: string
          format: date-time
      - name: x-request-id
        in: header
        description: Unique identifier of incoming call for tracing purposes
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsagesResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        default:
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /datashare/v1/{businessUnit}/{label}/dataconsumer/{dataOwnerId}/{productType}/metadata:
    get:
      tags:
      - DataConsumer
      summary: Get metadata of data owner for data consumers
      description: Get metadata of data owner for data consumers by validating contract via KPN
      operationId: Get metadata of data owner for data consumers
      parameters:
      - name: businessUnit
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/BusinessUnitBinding'
      - name: label
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/LabelBinding'
      - name: dataOwnerId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: productType
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ProductTypeBinding'
      - name: x-request-id
        in: header
        description: Unique identifier of incoming call for tracing purposes
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsagesResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        default:
          description: Unexpected Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              message:
                type: string
    BusinessUnit:
      enum:
      - nl
      - be
      - uk
    Units:
      enum:
      - Centigrade
      - KiloWattHour
      - CubicMeter
    UsageChannel:
      required:
      - channelId
      - unit
      - usageRecords
      type: object
      properties:
        channelId:
          type: string
        unit:
          $ref: '#/components/schemas/Units'
        usageRecords:
          type: array
          items:
            $ref: '#/components/schemas/UsageRecord'
    LabelBinding:
      enum:
      - default
      - eneco
      - oxxio
      - woonenergie
      type: object
      properties:
        value:
          $ref: '#/components/schemas/Label'
    UsageRecord:
      required:
      - amount
      - timestamp
      type: object
      properties:
        amount:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          format: double
        timestamp:
          type: string
          format: date-time
    ProductTypeBinding:
      enum:
      - heat
      type: object
      properties:
        value:
          $ref: '#/components/schemas/ProductType'
    BusinessUnitBinding:
      enum:
      - nl
      - be
      - uk
      type: object
      properties:
        value:
          $ref: '#/components/schemas/BusinessUnit'
    UsagesResponse:
      required:
      - startDate
      - endDate
      - usageChannels
      type: object
      properties:
        startDate:
          type: string
          format: date-time
        endDate:
          type: string
          format: date-time
        usageChannels:
          type: array
          items:
            $ref: '#/components/schemas/UsageChannel'
    ProductType:
      enum:
      - heat
    Label:
      enum:
      - default
      - eneco
      - oxxio
      - woonenergie
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
        title:
          type:
          - string
          - 'null'
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          format: int32
        detail:
          type:
          - string
          - 'null'
        instance:
          type:
          - string
          - 'null'
  securitySchemes:
    apikey:
      type: apiKey
      description: Apigee API key
      name: apikey
      in: header