Simpelsubsidie API v2 documentation


Simpel Subsidie offers her partners the possibility to set up a subsidy request for their customers. This process is as follows:

  1. Your customer has bought a product, like a heapump, a solarboiler or some form of isolation.
  2. The data of this cusomer is saved in your own database.
  3. This API allows you to transfer this data to the database of Simpel Subsidie.
    Necessary steps are:
    1. Create a new subsidy request in the API, and add these properties:
      • Salutation
      • Initials and lastname
      • Email
      • Streetname and housenumber
      • Postalcode and city
      • Phonenumber
      • Date of purchase and date of installation
      • Optionally: IBAN and BSN
    2. Add installations to this subsidy request in the API.
      An installation can be a heatpump, a solarboiler or some form of isolation.
      Each installation as a unique reporting code, given by our government. It acts as an ID of the installation.
      Installations can be linked to a subsidy request with this reporting code.
      The API also allows you to search for reporting codes based on a search query.
      If you'd like, Simpel Subsidie can provice you with a list of reporting codes for the installations that your company sells.
      Feel free to contact david@simpelsubsidie.nl for such a list.
    3. Add files to the subsidyrequest in the API, like invoices, proof of payements and pictures of installation.
  4. The API will generate a secured URL for each subsidy request.
    When you've completed the subsidy request, this URL can be mailed to your customer.
  5. Your customer will open the link, check the data, fill in the blanks, and can submit his subsidy request to Simpel Subsidie.
  6. If requested, Simpel Subsidy can use your webhook to update your backend when the status of the request changes on our end.
    Feel free to provide the necessary information by mailing david@simpelsubsidie.nl

For technical questions, feel free to contact david@simpelsubsidie.nl
For all other questions, please contact info@simpelsubsidie.nl


SimpelSubsidie API v2:

Full documentation and examples are available here:

>> Open full Documentation <<

Summary of endpoints:

RequestURLdescription
GETapi.simpelsubsidie.nl/v2/installations/{searchquery}searches for installations
GETapi.simpelsubsidie.nl/v2/installations/{reportingcode}returns specific installation
GETapi.simpelsubsidie.nl/v2/installations/visiblereturns the installations that are marked as hidden of visible
GETapi.simpelsubsidie.nl/v2/subsidyrequests/{id}returns a subsidyrequest
GETapi.simpelsubsidie.nl/v2/subsidyrequests/{emailaddress}returns a subsidyrequest
GETapi.simpelsubsidie.nl/v2/subsidyrequests/externalreference/{externalreference}returns a subsidyrequest
POSTapi.simpelsubsidie.nl/v2/subsidyrequestscreates a new subsidyrequest
PATCHapi.simpelsubsidie.nl/v2/subsidyrequests/{id}updates a subsidyrequest
GETapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/selectedinstallationsreturns the selected installations for a subsidyrequest
POSTapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/selectedinstallationsadds installations to a subsidyrequest
DELETEapi.simpelsubsidie.nl/v2/subsidyrequests/{id}selectedinstallations/{id}removes a selected installation from a subsidyrequest
GETapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/uploadsreturns all uploads linked to a subsidyrequest
POSTapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/uploadsuploads files to a subsidyrequest
DELETEapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/uploads/{id}deletes an upload from a subsidyrequest
GETapi.simpelsubsidie.nl/v2/subsidyrequests/{id}/requirementsreturns all subsidy requirements for a subsidyrequest
GETapi.simpelsubsidie.nl/v2/requirements/{type}returns all subsidy requirements for a given type
GETapi.simpelsubsidie.nl/v2/usersreturns information for all subdomain user between two dates

Generic measures

When reportingcodes are yet to be determined for a customer, you can apply our generic reportingcodes to still create a subsidyrequest.

Reporting code Type Category Material
ISO1008 Bodemisolatie Bodemisolatie
ISO1002 Dakisolatie Dakisolatie
ISO1001 Gevelisolatie Gevelisolatie
ISO1005 Isolerend glas 1 Isolerend glas HR++
ISO1007 Isolerend glas 2 Isolerend glas Triple glas
ISO1000 Spouwmuurisolatie Spouwmuurisolatie
MZS Maatregel zonder subsidie subsidieloos
ISO1004 Vloerisolatie Vloerisolatie
ISO1006 Zolder- of vlieringvloer Zolder- of vlieringvloer
ISO2000 Kozijnpanelen HR Kozijnpanelen HR++
ISO2001 Kozijnpanelen Triple Glas Kozijnpanelen Triple glas
VEN1002 Balansventilatie met WTW Centrale balansventilatie WTW
VEN1001 CO2-gestuurde ventilatie Centrale CO2 gestuurde mech ventilatie
VEN1003 Decentrale Balansventilatie met WTW Decentrale balansventilatie WTW
WN00001 Warmtenetaansluiting Warmtenetaansluiting
GEN1003 Grond (Brine)/water-warmtepomp Grond (Brine)/water-warmtepomp
GEN1001 Hybride warmtepomp Hybride-warmtepomp
GEN1000 Lucht/water-warmtepomp Lucht/water-warmtepomp
GEN1004 Warmtepompboiler Lucht/water-warmtepomp
GEN1005 Full electric warmtepomp - klein Lucht/water-warmtepomp
GEN1006 Full electric warmtepomp - middel Lucht/water-warmtepomp
GEN1007 Full electric warmtepomp - groot Lucht/water-warmtepomp
GEN1002 Water/water-warmtepomp Water/water-warmtepomp