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