{"openapi":"3.1.0","info":{"title":"German research allowance awards","version":"1.0.0","description":"Every published award of Germany's research allowance (Forschungszulage, EU aid measure SA.56245) from the EU Transparency Award Module. Only awards above €100000 are published there, amounts as ranges. Free to use, no key, CORS open. Please credit the European Commission's Transparency Award Module as the source.","license":{"name":"Data: European Commission reuse policy (Decision 2011/833/EU)"}},"servers":[{"url":"https://researchallowance.com"}],"paths":{"/api/awards":{"get":{"summary":"List awards","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search in company name and register number"},{"name":"region","in":"query","schema":{"type":"string"},"description":"Exact region, e.g. Bayern"},{"name":"sector","in":"query","schema":{"type":"string"},"description":"Exact NACE sector text"},{"name":"size","in":"query","schema":{"type":"string","enum":["sme","large"]}},{"name":"year","in":"query","schema":{"type":"integer"},"description":"Year the award was granted"},{"name":"minAmount","in":"query","schema":{"type":"integer"},"description":"Minimum lower range bound in euros"},{"name":"sort","in":"query","schema":{"type":"string","enum":["granted","amount","name"],"default":"granted"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":1000}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Matching awards","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"object"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"awards":{"type":"array","items":{"$ref":"#/components/schemas/Award"}}}}}}}}}},"/api/awards.csv":{"get":{"summary":"Download awards as CSV","description":"Same filters as /api/awards. Without limit, every matching row.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search in company name and register number"},{"name":"region","in":"query","schema":{"type":"string"},"description":"Exact region, e.g. Bayern"},{"name":"sector","in":"query","schema":{"type":"string"},"description":"Exact NACE sector text"},{"name":"size","in":"query","schema":{"type":"string","enum":["sme","large"]}},{"name":"year","in":"query","schema":{"type":"integer"},"description":"Year the award was granted"},{"name":"minAmount","in":"query","schema":{"type":"integer"},"description":"Minimum lower range bound in euros"},{"name":"sort","in":"query","schema":{"type":"string","enum":["granted","amount","name"],"default":"granted"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":1000}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"CSV file","content":{"text/csv":{}}}}}},"/api/stats":{"get":{"summary":"Totals by year, region, sector and amount range","responses":{"200":{"description":"Statistics"}}}}},"components":{"schemas":{"Award":{"type":"object","properties":{"ref":{"type":"string","description":"TAM reference number, unique per award","example":"TM-11223354"},"registerId":{"type":["string","null"],"description":"Commercial register number (null for private persons)","example":"HRB 9014 NP"},"name":{"type":["string","null"],"description":"Company name (null for private persons)","example":"Andrenomed AG"},"sme":{"type":"boolean","description":"Small or medium-sized enterprise"},"region":{"type":"string","example":"Brandenburg"},"sector":{"type":"string","description":"NACE sector","example":"Research and experimental development on natural sciences and engineering"},"objective":{"type":"string","example":"Industrial research (Art. 25(2)(b))"},"amountFrom":{"type":"integer","description":"Lower end of the published range, in euros","example":1000001},"amountTo":{"type":["integer","null"],"description":"Upper end of the range, in euros (null = open-ended)","example":2000000},"amountText":{"type":"string","description":"The range exactly as TAM publishes it","example":"1,000,001 to 2,000,000 EUR"},"granted":{"type":"string","format":"date"},"published":{"type":"string","format":"date"},"taxOffice":{"type":"string","example":"Finanzamt Oranienburg"}}}}}}