getapi-nl RVO API
The RVO API from getapi-nl — 1 operation(s) for rvo.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getapi-nl:getapi-nl-rvo-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: GetApi RVO API
version: 0.0.1
description: '## Authentication
All API endpoints require authentication. Include your API key in every request using **one** of the following methods:
**Option 1 — X-Api-Key header (recommended)**
```
X-Api-Key: ga_live_xxxxxxxxxxxxxxxxxxxx
```
**Option 2 — Bearer token**
```
Authorization: Bearer ga_live_xxxxxxxxxxxxxxxxxxxx
```
You can generate and manage API keys in your dashboard.
## AI & Agent Payments (x402)
Some endpoints support direct payments for AI agents via the **x402** protocol (https://www.x402.org).
No API key or account is needed. Send a normal request without key;
the server will respond with **HTTP 402** and a `PAYMENT-REQUIRED` header:
```
PAYMENT-REQUIRED:
```
This base64 string contains, among other things, `network`, `asset`, `amount`, and `payTo`.
Your agent signs an EIP-3009 *transferWithAuthorization* for the specified `amount` of USDC to that `payTo` address,
encodes the signature as base64, and resubmits the request with:
```
PAYMENT-SIGNATURE:
```
The server verifies the signature via a facilitator, provides the data, and settles the payment on-chain.
The success response includes a `PAYMENT-RESPONSE` header containing the transaction information.
A one-time `nonce` prevents replay attacks. Payments are made in USDC on **Base**;
the price is determined by the `credit_cost` of the endpoint.'
contact:
email: info@wdnoord.nl
x-guidance: 'GetAPI.nl is een Nederlandse API-platform voor lookups en validaties (postcode,
adres, kenteken, BTW, e-mail, KVK, IBAN, energiemaatwerk, overheidsdata). Elke
endpoint accepteert een API key via de X-Api-Key header of Authorization:
Bearer <key>.
Sommige endpoints zijn ook direct betaalbaar voor AI-agents via het x402-protocol
(https://www.x402.org) zonder account of API key: stuur een verzoek zonder key,
de server antwoordt met HTTP 402 en een PAYMENT-REQUIRED header (base64 JSON met
network, asset, amount, payTo). Teken daarna een EIP-3009 transferWithAuthorization
voor het gevraagde bedrag in USDC op Base en hertrail met een PAYMENT-SIGNATURE
header. De server verifieert, levert de data en settleert on-chain.
Tips voor agents:
- Lees eerst de PAYMENT-REQUIRED header van een 402-antwoord; die is leidend.
- Geef altijd de exact door de server gevraagde parameters mee.
- Een endpoint met een "x-payment-info" blok vereist betaling voor gebruik.'
servers:
- url: https://api.getapi.nl
description: GetAPI
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: RVO
paths:
/v1/property/energy-label:
get:
operationId: property.energy-label
description: 'Returns the registered energy label(s) for a Dutch address from EP-Online (RVO).
Each label carries the complete EP-Online record (field names are translated
to English; fields that EP-Online does not provide for that label are `null`).
Results are cached for 24 hours.
Source: EP-Online by RVO'
summary: Energy label lookup for a Dutch address
tags:
- RVO
parameters:
- name: zipcode
in: query
required: true
schema:
type: string
pattern: ^[1-9][0-9]{3}\s?[A-Za-z]{2}$
- name: house_number
in: query
required: true
schema:
type: integer
minimum: 1
maximum: 99999
- name: house_letter
in: query
schema:
type:
- string
- 'null'
pattern: ^[a-zA-Z]{1}$
- name: house_number_addition
in: query
schema:
type:
- string
- 'null'
pattern: ^[a-zA-Z0-9]{1,4}$
maxLength: 4
responses:
'200':
description: Energy label found
content:
application/json:
schema:
type: object
examples:
- found: true
labels:
- registration_date: '2024-08-30T22:25:14.623'
recording_date: '2024-08-26T00:00:00'
valid_until: '2034-08-26T00:00:00'
certificate_holder: Prosperos B.V.
recording_type: Basisopname
status: Bestaand
calculation_type: NTA 8800:2024 (basisopname utiliteitsbouw)
is_simplified_label: null
based_on_reference_building: false
building_class: Utiliteitsbouw
building_type: null
building_subtype: null
sbi_code: null
zipcode: 1012LG
house_number: 1
house_letter: null
house_number_addition: null
detail_description: null
bag_residence_id: 0363010012111931
bag_mooring_id: null
bag_stand_id: null
bag_building_ids:
- 0363100012185508
construction_year: 1890
usable_area_thermal_zone: 16131.58
compactness: 0.51
energy_class: A+
energy_index: null
energy_index_emg_forfeit: null
energy_demand: 112.77
primary_fossil_energy: 177.25
primary_fossil_energy_emg_forfeit: null
renewable_energy_share: 19.4
renewable_energy_share_emg_forfeit: null
temperature_overrun: null
heat_demand: 74.62
requirement_energy_demand: null
requirement_primary_fossil_energy: null
requirement_renewable_energy_share: null
requirement_temperature_overrun: null
calculated_co2_emission: 36.99
calculated_energy_consumption: 177.24
properties:
found:
type: boolean
labels:
type: array
items:
type: object
additionalProperties: []
required:
- found
- labels
'422':
$ref: '#/components/responses/ValidationException'
'404':
description: Not found
content:
application/json:
schema:
type: object
examples:
- found: false
labels: []
error: not_found
message: Niet gevonden.
properties:
found:
type: boolean
labels:
type: array
items: []
error:
type: string
message:
type: string
required:
- found
- labels
- error
- message
'402':
description: Payment Required
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.010000'
protocols:
- x402: {}
components:
responses:
ValidationException:
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Machine-readable error code.
message:
type: string
description: Human-readable error message.
errors:
type: object
description: A detailed description of each field that failed validation.
additionalProperties:
type: array
items:
type: string
required:
- error
- message
- errors
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
BearerAuth:
type: http
scheme: bearer