{"openapi":"3.1.0","info":{"title":"Bolrach ERP API","version":"1.0.0","description":"A scoped read slice of the DGUMS ERP engine, starting with the corporate registry: the group's registered legal entities with their public-record identifiers. Deeper ERP surfaces (directory, invoices) follow on the same scope model.","contact":{"url":"https://docs.bolrach.com/erp"}},"servers":[{"url":"https://api.bolrach.com"}],"security":[{"bearerKey":[]},{"headerKey":[]}],"paths":{"/v1/erp/companies":{"get":{"operationId":"erpCompanies","summary":"List registered entities","responses":{"200":{"description":"All active entities.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"companies":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Stable entity code (the path key)."},"name":{"type":"string"},"classification":{"type":["string","null"],"description":"for_profit | non_profit | ..."},"brand":{"type":["string","null"]},"country":{"type":["string","null"]},"jurisdiction":{"type":["string","null"]},"currency":{"type":["string","null"]},"reg_type":{"type":["string","null"],"description":"Registration scheme (RC, CBCA, ...)."},"reg_number":{"type":["string","null"],"description":"Public registration / corporation number."},"charity_registration_no":{"type":["string","null"]},"status":{"type":["string","null"]}}}}},"required":["count","companies"]}}}},"400":{"description":"Bad input (`bad_request`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"403":{"description":"Key lacks the `erp:read` scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"404":{"description":"No such company.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"429":{"description":"Rate limit or daily quota exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}}}}},"/v1/erp/companies/{code}":{"get":{"operationId":"erpCompany","summary":"One entity by code","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"AKEWE"}],"responses":{"200":{"description":"The entity.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable entity code (the path key)."},"name":{"type":"string"},"classification":{"type":["string","null"],"description":"for_profit | non_profit | ..."},"brand":{"type":["string","null"]},"country":{"type":["string","null"]},"jurisdiction":{"type":["string","null"]},"currency":{"type":["string","null"]},"reg_type":{"type":["string","null"],"description":"Registration scheme (RC, CBCA, ...)."},"reg_number":{"type":["string","null"],"description":"Public registration / corporation number."},"charity_registration_no":{"type":["string","null"]},"status":{"type":["string","null"]}}}}}},"400":{"description":"Bad input (`bad_request`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"403":{"description":"Key lacks the `erp:read` scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"404":{"description":"No such company.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}},"429":{"description":"Rate limit or daily quota exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"required":["code","message","status"]}},"required":["error"]}}}}}}}},"components":{"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"Authorization: Bearer bt_..."},"headerKey":{"type":"apiKey","in":"header","name":"x-api-key"}}}}