{"openapi":"3.1.0","info":{"title":"DCPaca — Japan Data Center Model Plan & Zoning Check","description":"DCPaca generates concept-stage data center model plans for Japanese sites and verifies them directly against building statutes: building coverage (建蔽率), floor-area ratio (容積率), rooftop tower 1/8 rule, road/neighbor/north slant lines, wall setbacks, and absolute height. Area programs use only public planning ratios (DOE/FEMP 2024, Uptime Institute, ENERGY STAR) with explicit confidence grades and sources. Every result separates pass/fail from needs_input so agents never mistake silence for compliance. japan zoning check, data center feasibility, 用途地域, 建蔽率, 容積率, 斜線制限, データセンター, モデルプラン, 基本計画, model plan, DC area program.","contact":{"name":"DCPaca","url":"https://dc-api-586747566167.asia-northeast1.run.app/","email":"hello@alpaca-army.com"},"license":{"name":"Proprietary"},"version":"0.1.0","x-guidance":"Japan data-center model plan and zoning check. POST /v1/dc/model-plan with JSON: {site: {area_m2, use_district, designated_bcr_pct, designated_far_pct, corner_lot_relief?, fireproof_relief?, district_plan_bonus_far_pct?, district_plan_setbacks?}, dc: {target_it_load_kw, pue_target?, rack_density_kw?, tier?, receiving_capacity_kw?}, max_height_m?, front_road_width_m?, ...}. Returns variants (dc_only/dc_50/dc_25) each with floor composition, power balance, legal compliance, and build-time consistency checks. Every rule result carries a confidence grade: A=statutory text certain, B=standard interpretation, C=confirm locally; and needs_input when a required parameter is missing. Cheaper probes: /v1/dc/legal-check ($0.01, 9-rule statutory check only) and /v1/dc/area-program ($0.05, area/equipment/power only). use_district keys: shogyo (商業), kinrin_shogyo (近隣商業), jun_kogyo (準工業), kogyo (工業), kogyo_senyo (工業専用), dai1_jukyo/dai2_jukyo/jun_jukyo (住居系), dai1_chukou/dai2_chukou (中高層), dai1_teiso/dai2_teiso (低層). All computation is deterministic from public statutes and public planning ratios (DOE, Uptime, ENERGY STAR) - no client data, no retention, JSON in/out. Concept-stage output for feasibility study, not licensed design. Unpaid calls return 402 with x402 terms.","x-logo":{"url":"https://dc-api-586747566167.asia-northeast1.run.app/logo.png","altText":"DCPaca"}},"paths":{"/v1/health":{"get":{"summary":"V1 Health","operationId":"v1_health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response V1 Health V1 Health Get"}}}}}}},"/v1/dc/legal-check":{"post":{"summary":"Japan zoning statutory check (9 rules)","description":"Direct statutory verification for a site + plan: coverage, FAR, rooftop tower, road/neighbor/north slant, absolute height, wall setbacks, shade flag. Every rule graded A/B/C with statute reference.","operationId":"legal_check_v1_dc_legal_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"amount":"0.01","currency":"USD"},"protocols":{"x402":{"scheme":"exact","asset":"USDC","networks":["eip155:8453","eip155:5042","eip155:137"],"payTo":"0x9099f2275875d2a56772f0158f36c9e42073e0e0","header":"Payment-Signature (x402 v2) or X-PAYMENT (v1)"}}}}},"/v1/dc/area-program":{"post":{"summary":"DC area program + equipment estimate","description":"Racks, white/grey space, UPS/generator sizing, receiving power from public planning ratios with confidence-graded assumptions.","operationId":"area_program_v1_dc_area_program_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaProgramRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"amount":"0.05","currency":"USD"},"protocols":{"x402":{"scheme":"exact","asset":"USDC","networks":["eip155:8453","eip155:5042","eip155:137"],"payTo":"0x9099f2275875d2a56772f0158f36c9e42073e0e0","header":"Payment-Signature (x402 v2) or X-PAYMENT (v1)"}}}}},"/v1/dc/model-plan":{"post":{"summary":"Full DC model plan (variants + legal + program)","description":"Concept-stage model plan: dc_only/dc_50/dc_25 variants with floor composition, power balance, legal compliance, and consistency checks.","operationId":"dc_model_plan_v1_dc_model_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelPlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"amount":"0.50","currency":"USD"},"protocols":{"x402":{"scheme":"exact","asset":"USDC","networks":["eip155:8453","eip155:5042","eip155:137"],"payTo":"0x9099f2275875d2a56772f0158f36c9e42073e0e0","header":"Payment-Signature (x402 v2) or X-PAYMENT (v1)"}}}}}},"components":{"schemas":{"AreaProgramRequest":{"properties":{"target_it_load_kw":{"type":"number","exclusiveMinimum":0.0,"title":"Target It Load Kw","description":"Target IT load in kW, e.g. 2000 for a 2 MW data center","examples":[2000]},"pue_target":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pue Target","description":"PUE target; default 1.4 (DOE/FEMP 2024)","examples":[1.4]},"rack_density_kw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rack Density Kw","description":"Average rack density in kW; default 10 (Uptime Institute), typical 10-30"},"tier":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Tier","description":"Availability tier 1-4; default 3. Drives redundancy N/N+1/2N"},"white_per_rack_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"White Per Rack M2","description":"White space per rack in m2; default 5"},"grey_to_white":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Grey To White","description":"Grey-to-white space ratio; default 0.35"},"receiving_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Receiving Margin","description":"Receiving-capacity margin over facility load; default 0.1"},"receiving_capacity_kw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Receiving Capacity Kw","description":"Planned receiving capacity in kW; when given, sufficiency is checked"}},"additionalProperties":true,"type":"object","required":["target_it_load_kw"],"title":"AreaProgramRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LegalCheckRequest":{"properties":{"site":{"$ref":"#/components/schemas/ZoningSite","description":"Site facts: district, area, designated ratios, reliefs"},"plan":{"anyOf":[{"$ref":"#/components/schemas/ZoningPlan"},{"type":"null"}],"description":"Planned building values. Omit any field you do not have; the affected check returns needs_input instead of guessing."}},"additionalProperties":true,"type":"object","required":["site"],"title":"LegalCheckRequest"},"ModelPlanDC":{"properties":{"target_it_load_kw":{"type":"number","exclusiveMinimum":0.0,"title":"Target It Load Kw","description":"Target IT load in kW, e.g. 2000 for a 2 MW data center","examples":[2000]},"pue_target":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pue Target","description":"PUE target; default 1.4 (DOE/FEMP 2024)","examples":[1.4]},"rack_density_kw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rack Density Kw","description":"Average rack density in kW; default 10 (Uptime Institute), typical 10-30"},"tier":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Tier","description":"Availability tier 1-4; default 3. Drives redundancy N/N+1/2N"},"white_per_rack_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"White Per Rack M2","description":"White space per rack in m2; default 5"},"grey_to_white":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Grey To White","description":"Grey-to-white space ratio; default 0.35"},"receiving_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Receiving Margin","description":"Receiving-capacity margin over facility load; default 0.1"},"receiving_capacity_kw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Receiving Capacity Kw","description":"Planned receiving capacity in kW; when given, sufficiency is checked"}},"additionalProperties":true,"type":"object","required":["target_it_load_kw"],"title":"ModelPlanDC","description":"DC block for model-plan: same fields as area-program (target_it_load_kw required)."},"ModelPlanRequest":{"properties":{"site":{"$ref":"#/components/schemas/ZoningSite","description":"Site facts: district, area, designated ratios, reliefs"},"dc":{"$ref":"#/components/schemas/ModelPlanDC","description":"DC requirements: target_it_load_kw plus optional planning overrides"},"dc_shares":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Dc Shares","description":"DC share variants to compose, each in (0, 1]; default [1.0, 0.5, 0.25] which yields dc_100 / dc_50 / dc_25","examples":[[1.0,0.5,0.25]]},"core_efficiency":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Core Efficiency","description":"Floor-plate core efficiency (usable / gross); default 0.85"},"office_load_w_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Office Load W M2","description":"Office electrical load in W/m2 for the non-DC share; default from public data"},"front_road_width_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Front Road Width M","description":"Front road width in meters, for road-slant check","examples":[8.0]},"max_height_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Height M","description":"Planned maximum height in meters, for slant/height checks","examples":[31.0]},"neighbor_distance_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Neighbor Distance M","description":"Distance to nearest side/rear neighbor boundary in meters"},"north_boundary_distance_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"North Boundary Distance M","description":"Distance to north boundary in meters"},"road_setback_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Road Setback M","description":"Facade setback from front road boundary in meters; default 0"},"rooftop_projection_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rooftop Projection M2","description":"Rooftop structure horizontal projection in m2 (1/8 tower rule)"},"setbacks":{"anyOf":[{"items":{"$ref":"#/components/schemas/SetbackPlanned"},"type":"array"},{"type":"null"}],"title":"Setbacks","description":"Planned wall setbacks as {boundary, planned_m} list"}},"additionalProperties":true,"type":"object","required":["site","dc"],"title":"ModelPlanRequest"},"SetbackPlanned":{"properties":{"boundary":{"type":"string","title":"Boundary","description":"Boundary label, e.g. 'north', 'east', 'road'"},"planned_m":{"type":"number","title":"Planned M","description":"Planned wall setback distance in meters","examples":[1.5]}},"additionalProperties":true,"type":"object","required":["boundary","planned_m"],"title":"SetbackPlanned"},"SetbackRequirement":{"properties":{"boundary":{"type":"string","title":"Boundary","description":"Boundary label, e.g. 'north', 'east', 'south', 'west', 'road'"},"required_m":{"type":"number","title":"Required M","description":"Required wall setback distance in meters","examples":[1.0]}},"additionalProperties":true,"type":"object","required":["boundary","required_m"],"title":"SetbackRequirement"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ZoningPlan":{"properties":{"building_area_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Building Area M2","description":"Planned building area in m2","examples":[2400]},"gfa_far_counted_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gfa Far Counted M2","description":"Total floor area counted toward FAR in m2","examples":[7200]},"rooftop_projection_m2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rooftop Projection M2","description":"Rooftop structure horizontal projection in m2 (1/8 tower rule)"},"max_height_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Height M","description":"Maximum building height in meters","examples":[31.0]},"front_road_width_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Front Road Width M","description":"Front road width in meters","examples":[8.0]},"road_setback_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Road Setback M","description":"Setback of the facade from the front road boundary in meters; default 0"},"neighbor_distance_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Neighbor Distance M","description":"Distance from the building to the nearest side/rear neighbor boundary in meters"},"north_boundary_distance_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"North Boundary Distance M","description":"Distance from the building to the north boundary in meters"},"setbacks":{"anyOf":[{"items":{"$ref":"#/components/schemas/SetbackPlanned"},"type":"array"},{"type":"null"}],"title":"Setbacks","description":"Planned wall setbacks as {boundary, planned_m} list, checked against site.district_plan_setbacks"}},"additionalProperties":true,"type":"object","title":"ZoningPlan"},"ZoningSite":{"properties":{"use_district":{"type":"string","title":"Use District","description":"Use district key (one of 12): shogyo, kinrin_shogyo, jun_kogyo, kogyo, kogyo_senyo, dai1_jukyo, dai2_jukyo, jun_jukyo, dai1_chukou, dai2_chukou, dai1_teiso, dai2_teiso","examples":["kogyo"]},"area_m2":{"type":"number","exclusiveMinimum":0.0,"title":"Area M2","description":"Site area in m2","examples":[4000]},"designated_bcr_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Designated Bcr Pct","description":"Designated building-coverage ratio in percent from city planning; defaults to the zone-type maximum","examples":[60]},"designated_far_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Designated Far Pct","description":"Designated floor-area ratio in percent from city planning; defaults to the zone-type maximum","examples":[200]},"corner_lot_relief":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Corner Lot Relief","description":"True if corner-lot coverage relief (+10pt) applies"},"fireproof_relief":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Fireproof Relief","description":"True if fireproof-building coverage relief (+10pt) applies"},"district_plan_bonus_far_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"District Plan Bonus Far Pct","description":"FAR bonus in percent granted by a district plan; default 0"},"absolute_height_limit_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Absolute Height Limit M","description":"Absolute height limit in meters for low-rise zones; default 10"},"district_plan_setbacks":{"anyOf":[{"items":{"$ref":"#/components/schemas/SetbackRequirement"},"type":"array"},{"type":"null"}],"title":"District Plan Setbacks","description":"Wall setbacks mandated by a district plan, as {boundary, required_m} list"}},"additionalProperties":true,"type":"object","required":["use_district","area_m2"],"title":"ZoningSite"}}},"externalDocs":{"url":"https://dc-api-586747566167.asia-northeast1.run.app/docs","description":"Interactive API docs (Swagger UI)"}}