---
title: "Get subsidy applications"
method: GET
path: "/subsidy-application"
tags: ["Subsidy Applications"]
---

# Get subsidy applications

`GET /subsidy-application`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/subsidy-application`
- Auth: API key in header `X-Api-Key`

Returns subsidy applications for the company ordered by creation time (newest first).

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated list of subsidy applications

- object
  - `items` SubsidyApplication[], required
    - `id` string, uuid
    - `project_id` string, uuid
    - `company_id` string, uuid
    - `state` 'dataCompletion' | 'supplyAndServiceContract' | 'submission' | 'submitted'
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `grant_recipient_type` 'privatePerson' | 'company' | 'brineWater', nullable
    - `grant_recipient_owner` 'singleFamilyHouse' | 'multiFamilyHouse' | 'no', nullable
    - `is_primary_residence` boolean
    - `yearly_net_income` 'moreThan40k' | 'lessThan40k' | 'unknown', nullable
    - `current_heating_system` 'oil' | 'coalOrNightStorage' | 'gas' | 'gasFloorHeating' | 'biomass' | 'heatpump' | 'districtHeating' | 'combinedHeatAndPowerUnit' | 'other' | 'noHeatingSystem', nullable
    - `is_current_heating_system_working` boolean
    - `will_current_heating_system_replaced` boolean
    - `current_heating_system_start_of_operation` string, date-time, nullable
    - `current_heating_system_kfw_type` 'gas' | 'gasFloorHeating' | 'oil' | 'nightStorage' | 'electricDirect' | 'coal' | 'biomassSolid' | 'biomassLiquid' | 'biomassGaseous' | 'biomassSingleStove' | 'solarThermalDomesticWater' | 'solarThermalHeating' | 'heatpumpAirWater' | 'heatpumpAirAir' | 'heatpumpBrineWater' | 'heatpumpWaterWater' | 'heatpumpGasDriven' | 'heatpumpOther' | 'bivalentHeatpumpBiomassElectric' | 'bivalentHeatpumpGasElectric' | 'districtHeating' | 'combinedHeatAndPowerUnit' | 'other' | 'noHeatingSystem', nullable: The existing heat generator as the KfW BzA portal lists it.
    - `current_heating_system_rated_output` number, nullable: Rated output of the existing heat generator in kW.
    - `current_heating_system_final_energy_consumption` number, nullable: Yearly final energy consumption of the existing heat generator in kWh/a.
    - `project_already_started` boolean
    - `is_building_heated_by_fossil_fuels_after_replacement` boolean
    - `qualifies_for_speed_bonus` boolean, nullable: KfW BzA "Boni" — whether the project qualifies for the Klimageschwindigkeitsbonus.
    - `speed_bonus_replaced_heatings` string[]: KfW BzA "Boni" — which heating kinds are replaced.
    - `building_construction_date` string, date-time, nullable
    - `building_usage_type` 'residential' | 'fullyCommercial', nullable
    - `building_category` 'accommodation' | 'careFacility' | 'daycare' | 'clinic' | 'warehouse' | 'workshop' | 'dataCenter' | 'school' | 'socialBuilding' | 'sportsFacility' | 'retailEstablishment' | 'officeBuilding' | 'otherCommercial' | 'otherHealthcare', nullable
    - `amount_of_apartments` number, nullable
    - `amount_of_subsidized_apartments` number, nullable
    - `will_more_than_one_building_connected_to_new_heating_system` boolean
    - `new_heating_system` 'heatpump' | 'biomass' | 'solarThermal' | 'districtHeating', nullable
    - `new_heating_system_combined_with` 'heatpump' | 'photovoltaic' | 'solarThermal' | 'noAdditionalCombination', nullable
    - `biomass_emission_value_compliance` boolean, nullable
    - `new_heatpump_type` 'airWater' | 'waterWater' | 'brineWater', nullable
    - `planned_heating_systems` string[]
    - `is_contracting` boolean, nullable
    - `heatpump_system_number` string, nullable
    - `heatpump_manufacturer` string, nullable
    - `heatpump_model` string, nullable
    - `heatpump_flow_temperature` 'celsius35' | 'celsius55', nullable
    - `new_heatpump_refrigerant` 'R290' | 'R32' | 'R134a' | 'R410A' | 'R452B' | 'R454C' | 'R600A' | 'R717' | 'R744' | 'R454B' | 'R407C' | 'R513A' | 'R1234ze(E)' | 'R449A' | 'R515B' | 'R417A' | 'R1234ze' | 'R404A', nullable
    - `net_heated_floor_area` number, nullable
    - `net_heated_floor_area_relevant_to_measure` number, nullable
    - `absolute_co2savings` number, nullable
    - `estimated_gross_cost` number, nullable
    - `allocated_living_space` number, nullable
    - `liability_insurance` boolean
    - `rated_output` number, nullable
    - `connected_load` number, nullable
    - `sent_at` string, date-time, nullable
    - `expected_implementation_date` string, date-time, nullable
    - `optional_message` string, nullable
    - `bza_id` string, nullable
    - `bza_funding_rate` number, nullable
    - `bza_comment` string, nullable
    - `application_date` string, date-time, nullable
    - `completed` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time, nullable
  - `metadata` object, required
    - `page` integer, required: Current page number
    - `limit` integer, required: Number of items per page
    - `total` integer, required: Total number of items

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)