---
title: "Structured read of a GeoJSON parcel boundary (Phase 3)"
method: POST
path: "/api/v1/analyze-parcel"
tags: ["Public"]
---

# Structured read of a GeoJSON parcel boundary (Phase 3)

`POST /api/v1/analyze-parcel`

## Request

- Base URL: `https://dchub.cloud`
- URL: `https://dchub.cloud/api/v1/analyze-parcel`
- Auth: none declared

Geodesic acreage + largest-member centroid as representative_point (never the multi-part center) + contiguous flag + per-member breakdown + a site_evaluation_handoff, for any GeoJSON Polygon/MultiPolygon. Reads any polygon you pass; DC Hub does not yet own parcel boundaries, so get_refined_queue survivors do not auto-carry geometry. Returns the DCHubEnvelope with _entity=parcel_analysis.

## Request body

- object
  - `geometry` object, required: GeoJSON Polygon or MultiPolygon parcel boundary
  - `capacity_mw` number: Optional target load in MW, passed into the handoff

## Response `200`

Parcel analysis (_entity=parcel_analysis)

- DCHubEnvelope: Universal response envelope for every DC Hub tool and endpoint. The STABLE anchor an agent branches on before parsing the entity payload: full-data, gated-preview and error responses all share it. `_entity` is the type discriminator; the entity-specific payload is passthrough (additionalProperties). Branch on `_entity` + `ok`.
  - `_entity` 'facility' | 'market' | 'grid' | 'fiber' | 'gas' | 'deal' | 'site' | 'news' | 'energy' | 'incentives' | 'risk' | 'index' | 'pipeline' | 'infrastructure' | 'export' | 'changes' | 'alert' | 'meta' | 'semantic_search' | 'error' | 'record', required: Payload type discriminator — branch on this before parsing.
  - `ok` boolean: Success flag; false + _entity='error' on failure.
  - `_source` string
  - `_cite` string: Attribution string (CC-BY-4.0).
  - `citation` object
    - `source` string
    - `url` string
    - `license` string
    - `cite_as` string
  - `next_session` object: Context-aware next-step hints — the agent's state-machine menu for what to call next.

---

[API](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api.md) · [All operations](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dchub/apis/dc-hub-data-center-intelligence-api/revisions/15f74d15cdeb?raw)