{"openapi":"3.0.3","info":{"title":"Registron API","version":"1.0.0","description":"German commercial-register data. All reads are served from Registron's own database; sources are never live-scraped on request.","contact":{"name":"createIF Labs","email":"api@createif-labs.de"}},"servers":[{"url":"/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}}},"Meta":{"type":"object","properties":{"credits_charged":{"type":"integer"},"data_as_of":{"type":"string","format":"date-time","nullable":true},"completeness":{"type":"integer"}}},"SearchHit":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"legal_form":{"type":"string"},"city":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true},"register_number":{"type":"string","nullable":true},"status":{"type":"string"},"data_completeness":{"type":"integer"}}}}},"paths":{"/search-organizations":{"get":{"summary":"Search organizations (autocomplete). Cost: 1 credit.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"postal_code","in":"query","schema":{"type":"string"}},{"name":"legal_form","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"sort","in":"query","schema":{"type":"string","enum":["name","completeness"]}}],"responses":{"200":{"description":"Matching organizations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SearchHit"}},"meta":{"type":"object","properties":{"credits_charged":{"type":"integer"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/fetch-organization":{"get":{"summary":"Fetch a full organization record by id or query term.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"UUID or search term"},{"name":"feature","in":"query","schema":{"type":"array","items":{"type":"string","enum":["persons","shareholders","financials","publications","enrichment"]}},"style":"form","explode":true}],"responses":{"200":{"description":"Organization record"},"404":{"description":"Not found"}}}},"/organizations/{id}":{"get":{"summary":"Full organization record. Cost: 2 credits + feature blocks.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"feature","in":"query","schema":{"type":"array","items":{"type":"string","enum":["persons","shareholders","financials","publications","enrichment"]}},"style":"form","explode":true}],"responses":{"200":{"description":"Organization record"},"404":{"description":"Not found"}}}},"/organizations/{id}/financials":{"get":{"summary":"Fiscal-year financial history.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Financials"}}}},"/organizations/{id}/persons":{"get":{"summary":"Current + historical management.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Persons"}}}}}}