@cenogram/mcp-server 0.2.0 → 0.5.0

package/dist/api-client.d.ts

@@ -44,14 +44,39 @@ export interface Transaction {
     floor: number | null;
     district: string | null;
     street: string | null;
+    address_source?: "rcn" | "approx_high" | "approx_low" | "none" | null;
     building_number: string | null;
     city: string | null;
     parcel_area: number | null;
     unit_function: number | null;
+    is_garage?: boolean | null;
+    area_basis?: "unit" | "building" | null;
     parcel_id: string | null;
     parcel_number: string | null;
     county_name: string | null;
     voivodeship_name: string | null;
+    share_basis?: "full" | "fraction" | "ambiguous" | null;
+    parcel_count?: number | null;
+    area_is_ha_converted?: boolean | null;
+    property_type_inferred?: boolean | null;
+    property_type_reclassed?: boolean | null;
+    ownership_type?: number | null;
+    ownership_share?: string | null;
+    seller_type?: number | null;
+    buyer_type?: number | null;
+    land_use?: string | null;
+    unit_price?: number | string | null;
+    vat?: number | string | null;
+    building_count?: number | null;
+    footprint_area_m2?: number | null;
+    est_total_area_m2?: number | null;
+    building_storeys?: number | null;
+    flood_risk?: "high" | "medium" | "low" | null;
+    flood_assessed?: boolean | null;
+    heritage_status?: "listed" | "zone" | null;
+    heritage_assessed?: boolean | null;
+    landslide_risk?: "landslide" | "threatened" | null;
+    landslide_assessed?: boolean | null;
     centroid: {
         type: string;
         coordinates: [number, number];
@@ -86,6 +111,230 @@ export interface HistogramBin {
     range_min: number;
     range_max: number;
 }
+export interface Percentiles {
+    p10: number | null;
+    p25: number | null;
+    p50: number | null;
+    p75: number | null;
+    p90: number | null;
+}
+export interface LocationRef {
+    name: string;
+    country_code: "PL";
+    location_type: "city" | "county";
+    teryt: string;
+}
+export interface TxWindow {
+    from: string | null;
+    to: string | null;
+}
+export interface RentalYieldResponse {
+    location: LocationRef;
+    metric: "indicative_gross_rental_yield";
+    currency: "PLN";
+    segment: {
+        market_type: "primary" | "secondary" | "all";
+        property_type: "apartment";
+        area_bucket: string | null;
+    };
+    result: {
+        gross_yield_pct: number | null;
+        calculation_method: "ratio_of_market_medians";
+        matched_observations: false;
+    };
+    inputs: {
+        rent: {
+            median_monthly_asking_per_m2: number | null;
+            annualized_per_m2: number | null;
+            sample_n: number | null;
+            snapshot_date: string | null;
+        };
+        transaction: {
+            median_price_per_m2: number | null;
+            sample_n: number | null;
+            window: TxWindow;
+        };
+    };
+    distribution: {
+        asking_rent_monthly_per_m2: Percentiles;
+        transaction_price_per_m2: Percentiles;
+    };
+    assumptions: {
+        vacancy_included: false;
+        tax_included: false;
+        maintenance_included: false;
+        transaction_costs_included: false;
+    };
+    quality: {
+        coverage: "full" | "low_sample" | "no_rental_data" | "suppressed" | "data_stale";
+        confidence: "high" | "low";
+        as_of: string | null;
+        stale: boolean;
+        notes: string[];
+    };
+}
+export interface RentalYieldLocation {
+    location: string;
+    county_code: string;
+    voivodeship: string;
+    type: "city" | "county";
+    rent_sample_n: number;
+    confidence: "high" | "low";
+}
+export interface RentalYieldLocationsResponse {
+    data: RentalYieldLocation[];
+    meta: {
+        total: number;
+        snapshot_date: string | null;
+    };
+}
+export interface PriceSpreadResponse {
+    location: LocationRef;
+    metric: "asking_to_transaction_price_spread";
+    currency: "PLN";
+    segment: {
+        market_type: "primary" | "secondary" | "all";
+        property_type: "apartment";
+        area_bucket: string | null;
+    };
+    result: {
+        spread_pct: number | null;
+        calculation_method: "relative_difference_of_market_medians";
+        matched_observations: false;
+    };
+    inputs: {
+        asking: {
+            median_price_per_m2: number | null;
+            sample_n: number | null;
+            snapshot_date: string | null;
+            window?: TxWindow;
+        };
+        transaction: {
+            median_price_per_m2: number | null;
+            sample_n: number | null;
+            window: TxWindow;
+        };
+    };
+    distribution: {
+        asking_sale_per_m2: Percentiles;
+        transaction_price_per_m2: Percentiles;
+    };
+    quality: {
+        coverage: "full" | "low_sample" | "no_asking_data" | "suppressed" | "data_stale";
+        confidence: "high" | "low";
+        as_of: string | null;
+        stale: boolean;
+        notes: string[];
+    };
+}
+export interface PriceSpreadLocation {
+    location: string;
+    county_code: string;
+    voivodeship: string;
+    type: "city" | "county";
+    asking_sample_n: number;
+    confidence: "high" | "low";
+}
+export interface PriceSpreadLocationsResponse {
+    data: PriceSpreadLocation[];
+    meta: {
+        total: number;
+        snapshot_date: string | null;
+    };
+}
+export interface DemographicsIndicator {
+    name: string;
+    unit: string;
+    variable_id: number | null;
+    category: string;
+    level: string;
+    values: Record<string, number>;
+    note?: string;
+    derived?: boolean;
+    snapshot?: boolean;
+    snapshot_note?: string;
+}
+export interface DemographicsResponse {
+    location: {
+        name: string | null;
+        country_code: "PL";
+        location_type: "city" | "county" | "municipality" | "voivodeship";
+        teryt: string;
+        level: string;
+        hierarchy?: Record<string, {
+            teryt: string | null;
+            name: string;
+        }>;
+    };
+    coverage: "full" | "no_data";
+    indicators: Record<string, DemographicsIndicator>;
+    meta: {
+        variables_count: number;
+        categories: string[];
+        levels_included: string[];
+        data_source: string;
+        as_of: string | null;
+    };
+    demo?: boolean;
+}
+export declare function getDemographics(params: {
+    location?: string;
+    teryt?: string;
+    year?: number;
+    yearFrom?: number;
+    yearTo?: number;
+    category?: string;
+}, apiKey?: string): Promise<ApiResponse<DemographicsResponse>>;
+export interface InfraTender {
+    title: string;
+    category: string;
+    notice_type: string;
+    published_at: string;
+    value_pln: number | null;
+    value_kind: string | null;
+    attribution_confidence: string | null;
+    bzp_url: string | null;
+}
+export interface InfrastructureSignalsResponse {
+    location: {
+        name: string | null;
+        country_code: "PL";
+        location_type: "city" | "county" | "municipality";
+        teryt: string;
+        level: string;
+    };
+    coverage: "full" | "partial" | "no_data";
+    tenders: {
+        window_months: number;
+        by_category: Record<string, number>;
+        recent: InfraTender[];
+        truncated: boolean;
+    };
+    kposk: {
+        in_agglomeration: boolean;
+        agglomerations: Array<{
+            name: string;
+            rlm: number | null;
+        }>;
+        truncated: boolean;
+    };
+    capex: {
+        by_year: Record<string, {
+            value_pln: number;
+            doc_category: string;
+            resolution_date: string | null;
+            gmina_count: number;
+        }>;
+    };
+    meta: {
+        coverage_note: string;
+        as_of: string | null;
+    };
+}
+export declare function getInfrastructureSignals(params: {
+    location?: string;
+    teryt?: string;
+}, apiKey?: string): Promise<ApiResponse<InfrastructureSignalsResponse>>;
 export interface CreditInfo {
     balance: number;
     cost: number;
@@ -94,7 +343,14 @@ export interface ApiResponse<T> {
     data: T;
     creditInfo: CreditInfo | null;
 }
+export declare const OAUTH_CTX_PREFIX = "\u0001";
 export declare function encodeOAuthCtx(userId: string, grantId: string): string;
+export declare function decodeOAuthCtx(key: string): {
+    userId: string;
+    grantId: string;
+} | null;
+export declare function parseRetryAfterSeconds(headerValue: string | null | undefined): number | null;
+export declare function formatRetryAfter(seconds: number): string;
 export declare function fetchApi<T>(path: string, params?: Record<string, string>, apiKey?: string): Promise<ApiResponse<T>>;
 export declare function fetchApiPost<T>(path: string, body: unknown, apiKey?: string): Promise<ApiResponse<T>>;
 export declare function getStats(apiKey?: string): Promise<ApiResponse<StatsResponse>>;
@@ -106,8 +362,9 @@ export interface TransactionParams {
     parcelId?: string;
     propertyType?: number;
     marketType?: number;
-    unitFunction?: number;
-    buildingType?: number;
+    unitFunction?: number | string;
+    buildingType?: number | string;
+    ownershipType?: number | string;
     mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
@@ -116,6 +373,12 @@ export interface TransactionParams {
     minArea?: number;
     maxArea?: number;
     bbox?: string;
+    transactionType?: string;
+    rooms?: string;
+    floor?: string;
+    floodRisk?: string;
+    heritageStatus?: string;
+    landslideRisk?: string;
     limit?: number;
     page?: number;
     sort?: string;
@@ -125,6 +388,88 @@ export declare function getTransactions(p: TransactionParams, apiKey?: string):
 export declare function getTransactionsSummary(p: TransactionParams, apiKey?: string): Promise<ApiResponse<TransactionsSummary>>;
 export declare function getPricePerM2(apiKey?: string): Promise<ApiResponse<PricePerM2Row[]>>;
 export declare function getDistricts(apiKey?: string): Promise<ApiResponse<string[]>>;
+export declare function getRentalYield(params: {
+    location?: string;
+    teryt?: string;
+    areaBucket?: string;
+}, apiKey?: string): Promise<ApiResponse<RentalYieldResponse>>;
+export declare function getRentalYieldLocations(params: {
+    search?: string;
+}, apiKey?: string): Promise<ApiResponse<RentalYieldLocationsResponse>>;
+export declare function getPriceSpread(params: {
+    location?: string;
+    teryt?: string;
+    marketType?: string;
+    areaBucket?: string;
+}, apiKey?: string): Promise<ApiResponse<PriceSpreadResponse>>;
+export declare function getPriceSpreadLocations(params: {
+    search?: string;
+}, apiKey?: string): Promise<ApiResponse<PriceSpreadLocationsResponse>>;
+export interface ValuationComparable {
+    distance_m: number;
+    transaction_date: string;
+    area_m2: number;
+    price_per_m2: number;
+    rooms: number | null;
+    floor: number | null;
+    market_type: "primary" | "secondary" | null;
+    district: string | null;
+    has_unit_number: boolean;
+    unit_number?: string | null;
+}
+export interface ValuationResponse {
+    location: {
+        country_code: string;
+        lat: number | null;
+        lng: number | null;
+        county_code: string | null;
+    };
+    metric: string;
+    currency: string;
+    segment: {
+        property_type: string;
+        market_type: "primary" | "secondary" | "all";
+        area_m2: number;
+        rooms: number | null;
+    };
+    result: {
+        estimated_value: number | null;
+        price_per_m2: number | null;
+        value_range_likely: {
+            low: number | null;
+            high: number | null;
+        };
+        value_range_wide: {
+            low: number | null;
+            high: number | null;
+        };
+        confidence: number | null;
+        confidence_band: "high" | "medium" | "low" | null;
+    };
+    inputs: {
+        comps_total: number;
+        radius_m: number | null;
+        window_months: number;
+        comparables: ValuationComparable[] | null;
+    };
+    quality: {
+        coverage: "covered" | "no_data" | "not_covered";
+        as_of: string | null;
+        price_basis: "apartment" | "deed";
+        ess: number | null;
+        accuracy_segment: "wwa" | "duze" | "srednie" | "male" | null;
+        note: string;
+    };
+}
+export declare function getValuation(params: {
+    lat?: number;
+    lng?: number;
+    parcelId?: string;
+    area: number;
+    rooms?: number;
+    market?: "primary" | "secondary";
+    includeComps?: boolean;
+}, apiKey?: string): Promise<ApiResponse<ValuationResponse>>;
 export interface LocationItem {
     code: string;
     name: string;
@@ -134,7 +479,7 @@ export interface LocationItem {
 export declare function getLocations(parent?: string, apiKey?: string): Promise<ApiResponse<LocationItem[]>>;
 export declare function getPriceHistogram(bins?: number, max?: number, apiKey?: string): Promise<ApiResponse<HistogramBin[]>>;
 export interface ParcelSearchResult {
-    parcel_id: string;
+    parcel_id?: string;
     district: string | null;
     area_m2: number | null;
     lat: number;
@@ -144,6 +489,140 @@ export interface ParcelSearchResponse {
     results: ParcelSearchResult[];
 }
 export declare function searchParcels(q: string, limit?: number, apiKey?: string): Promise<ApiResponse<ParcelSearchResponse>>;
+export interface ParcelResolveMatch {
+    id: string;
+    parcel_id: string | null;
+    parcel_key: string | null;
+    district: string | null;
+    county_code: string | null;
+    parcel_number: string | null;
+    area_m2: number | null;
+    has_geometry: boolean;
+    centroid: {
+        lat: number;
+        lng: number;
+    } | null;
+}
+export interface ParcelResolveResponse {
+    query: {
+        mode: string;
+        q?: string;
+        parcelId?: string;
+        lat?: number;
+        lng?: number;
+    };
+    coverage: "covered" | "not_covered";
+    as_of: string | null;
+    matches: ParcelResolveMatch[];
+    truncated: boolean;
+}
+export interface ResolveParcelParams {
+    q?: string;
+    parcelId?: string;
+    lat?: number;
+    lng?: number;
+}
+export declare function resolveParcel(params: ResolveParcelParams, apiKey?: string): Promise<ApiResponse<ParcelResolveResponse>>;
+export interface ReportMarketLevel {
+    coverage: string;
+    median_price_per_m2: number | null;
+    n: number;
+    county_code?: string | null;
+    district?: string | null;
+}
+export interface ReportMarketContext {
+    coverage: string;
+    as_of: string | null;
+    county: ReportMarketLevel;
+    locality: ReportMarketLevel;
+    note?: string | null;
+}
+export interface ReportDemographicsSection {
+    coverage: string;
+    as_of: string | null;
+    name: string | null;
+    indicators: Record<string, DemographicsIndicator>;
+}
+export interface ReportInfraSection {
+    coverage: string;
+    as_of: string | null;
+    gmina_name: string | null;
+    tenders: {
+        window_months: number;
+        by_category: Record<string, number>;
+        recent: InfraTender[];
+        truncated: boolean;
+    };
+    kposk: {
+        in_agglomeration: boolean;
+        agglomerations: Array<{
+            name: string;
+            rlm: number | null;
+        }>;
+        truncated: boolean;
+    };
+    capex: {
+        by_year: Record<string, unknown>;
+    };
+    note?: string | null;
+}
+export interface ReportLocationContext {
+    coverage: string;
+    as_of: string | null;
+    gmina_teryt: string | null;
+    demographics: ReportDemographicsSection;
+    infra_signals: ReportInfraSection;
+    note?: string | null;
+}
+export interface ReportSection {
+    coverage: string;
+    as_of: string | null;
+    note?: string | null;
+    [key: string]: unknown;
+}
+export interface ParcelReportResponse {
+    parcel: {
+        id: string | null;
+        parcel_id: string | null;
+        parcel_key: string | null;
+        district?: string | null;
+        county_code?: string | null;
+        county_name?: string | null;
+        voivodeship_name?: string | null;
+        parcel_number?: string | null;
+        area_m2?: number | null;
+        land_use?: string | null;
+        mpzp_designation?: string | null;
+        has_geometry?: boolean;
+        centroid?: {
+            lat: number;
+            lng: number;
+        } | null;
+    };
+    coverage: string;
+    as_of: string | null;
+    sections: {
+        transactions: ReportSection;
+        flood: ReportSection;
+        heritage: ReportSection;
+        landslide: ReportSection;
+        surroundings: ReportSection;
+        transit: ReportSection;
+        planning: ReportSection;
+        buildings: ReportSection;
+        permits: ReportSection;
+        farmland: ReportSection;
+        market_context: ReportMarketContext;
+        location_context: ReportLocationContext;
+    };
+    billing: {
+        charged: number;
+        refunded: number;
+        rule: string;
+    };
+    note?: string | null;
+}
+export declare function getParcelReport(parcelKey: string, apiKey?: string): Promise<ApiResponse<ParcelReportResponse>>;
 export interface SpatialSearchParams {
     polygon: {
         type: "Polygon";
@@ -151,8 +630,9 @@ export interface SpatialSearchParams {
     };
     propertyType?: number;
     marketType?: number;
-    unitFunction?: number;
-    buildingType?: number;
+    unitFunction?: number | string;
+    buildingType?: number | string;
+    ownershipType?: number | string;
     mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
@@ -162,6 +642,9 @@ export interface SpatialSearchParams {
     maxArea?: number;
     district?: string;
     street?: string;
+    transactionType?: string;
+    rooms?: string;
+    floor?: string;
     limit?: number;
 }
 export interface SpatialFeatureProperties {
@@ -175,11 +658,30 @@ export interface SpatialFeatureProperties {
     rooms: number | null;
     floor: number | null;
     street: string | null;
+    address_source?: "rcn" | "approx_high" | "approx_low" | "none" | null;
     building_number: string | null;
     city: string | null;
     district: string | null;
     parcel_area: number | null;
     parcel_number: string | null;
+    share_basis?: "full" | "fraction" | "ambiguous" | null;
+    is_garage?: boolean | null;
+    area_basis?: "unit" | "building" | null;
+    parcel_count?: number | null;
+    area_is_ha_converted?: boolean | null;
+    property_type_inferred?: boolean | null;
+    property_type_reclassed?: boolean | null;
+    ownership_type?: number | null;
+    ownership_share?: string | null;
+    seller_type?: number | null;
+    buyer_type?: number | null;
+    land_use?: string | null;
+    unit_price?: number | string | null;
+    vat?: number | string | null;
+    building_count?: number | null;
+    footprint_area_m2?: number | null;
+    est_total_area_m2?: number | null;
+    building_storeys?: number | null;
 }
 export interface SpatialFeature {
     type: "Feature";
@@ -196,6 +698,14 @@ export interface SpatialSearchResponse {
     total: number;
 }
 export declare function searchByPolygon(p: SpatialSearchParams, apiKey?: string): Promise<ApiResponse<SpatialSearchResponse>>;
+export interface CompareDemographicsIndicator {
+    value: number | null;
+    year: number | null;
+    unit: string;
+    derived?: boolean;
+    cross_source?: boolean;
+    note?: string;
+}
 export interface CompareEntry {
     median_price_m2: number | null;
     avg_area: number | null;
@@ -203,14 +713,16 @@ export interface CompareEntry {
     max_date: string | null;
     total: number;
     suggestions?: string[];
+    demographics?: Record<string, CompareDemographicsIndicator>;
 }
 export type CompareResponse = Record<string, CompareEntry>;
 export interface CompareParams {
     districts: string;
     propertyType?: number;
     marketType?: number;
-    unitFunction?: number;
-    buildingType?: number;
+    unitFunction?: number | string;
+    buildingType?: number | string;
+    ownershipType?: number | string;
     mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
@@ -219,5 +731,164 @@ export interface CompareParams {
     minArea?: number;
     maxArea?: number;
     street?: string;
+    transactionType?: string;
+    rooms?: string;
+    floor?: string;
+    include?: string;
 }
 export declare function compareLocations(p: CompareParams, apiKey?: string): Promise<ApiResponse<CompareResponse>>;
+export interface BuildingBreakdownRow {
+    building_type: number | null;
+    footprint_area_m2: number | null;
+    footprint_area_alt_m2: number | null;
+    footprint_divergent: boolean | null;
+    storeys: number | null;
+    est_total_area_m2: number | null;
+    match_confidence: string | null;
+}
+export interface BuildingBreakdownResponse {
+    data: BuildingBreakdownRow[];
+    truncated: boolean;
+}
+export declare function getBuildingBreakdown(transactionId: string, apiKey?: string): Promise<ApiResponse<BuildingBreakdownResponse>>;
+export interface FloodScenario {
+    scenario: string | null;
+    source: string | null;
+    returnPeriod: number | null;
+    severity: number;
+    isLeveeFailure: boolean;
+    depthClass: string | null;
+}
+export interface FloodBreakdownRow {
+    flood_risk: "high" | "medium" | "low" | null;
+    severity_rank: number | null;
+    worst_scenario: string | null;
+    source: string | null;
+    depth_class: string | null;
+    pct_in_zone: number | string | null;
+    nearest_zone_m: number | null;
+    scenarios: FloodScenario[] | null;
+}
+export interface FloodBreakdownResponse {
+    data: FloodBreakdownRow[];
+    truncated: boolean;
+}
+export declare function getTransactionFlood(transactionId: string, apiKey?: string): Promise<ApiResponse<FloodBreakdownResponse>>;
+export interface HeritageSite {
+    category: string;
+    name?: string | null;
+    function: string | null;
+    period: string | null;
+    entry_date: string | null;
+}
+export interface HeritageBreakdownRow {
+    heritage_status: "listed" | "zone" | null;
+    severity_rank: number | null;
+    pct_in_zone: number | string | null;
+    site_count: number | null;
+    sites: HeritageSite[] | null;
+}
+export interface HeritageBreakdownResponse {
+    data: HeritageBreakdownRow[];
+    truncated: boolean;
+}
+export interface LandslideZone {
+    kind: string | null;
+    source_version_date: string | null;
+}
+export interface LandslideBreakdownRow {
+    landslide_risk: "landslide" | "threatened" | null;
+    severity_rank: number | null;
+    pct_in_zone: number | string | null;
+    zones: LandslideZone[] | null;
+}
+export interface LandslideBreakdownResponse {
+    data: LandslideBreakdownRow[];
+    truncated: boolean;
+}
+export interface TransitBreakdownRow {
+    rail_distance_m: number | null;
+    rail_stop_name: string | null;
+    metro_distance_m: number | null;
+    metro_stop_name: string | null;
+    tram_distance_m: number | null;
+    tram_stop_name: string | null;
+    bus_distance_m: number | null;
+    bus_stop_name: string | null;
+}
+export interface TransitBreakdownResponse {
+    data: TransitBreakdownRow[];
+    truncated: boolean;
+}
+export interface PermitRecord {
+    record_kind: "permit" | "notification";
+    intent_type: string | null;
+    object_category: string | null;
+    works_type: string | null;
+    status: string | null;
+    decision_date: string | null;
+    intake_date: string | null;
+    authority: string | null;
+    address_street: string | null;
+    address_number: string | null;
+    address_city: string | null;
+    volume_m3: number | null;
+}
+export interface PermitsResponse {
+    data: PermitRecord[];
+    truncated: boolean;
+    note?: string;
+}
+export declare function getTransactionHeritage(transactionId: string, apiKey?: string): Promise<ApiResponse<HeritageBreakdownResponse>>;
+export declare function getTransactionLandslide(transactionId: string, apiKey?: string): Promise<ApiResponse<LandslideBreakdownResponse>>;
+export interface SurroundingsRow {
+    assessed: boolean;
+    cemetery_distance_m: number | string | null;
+    landfill_distance_m: number | string | null;
+    sewage_treatment_distance_m: number | string | null;
+    industrial_area_distance_m: number | string | null;
+    industrial_plant_distance_m: number | string | null;
+    livestock_farm_distance_m: number | string | null;
+}
+export interface SurroundingsResponse {
+    data: SurroundingsRow[];
+    truncated?: boolean;
+}
+export declare function getTransactionSurroundings(transactionId: string, apiKey?: string): Promise<ApiResponse<SurroundingsResponse>>;
+export declare function getTransactionTransit(transactionId: string, apiKey?: string): Promise<ApiResponse<TransitBreakdownResponse>>;
+export declare function getTransactionPermits(transactionId: string, apiKey?: string): Promise<ApiResponse<PermitsResponse>>;
+export interface PlanningRow {
+    parcel_ord: number;
+    kind: string;
+    zone_symbol: string | null;
+    zone_name: string | null;
+    pct_of_parcel: number | string | null;
+    max_building_height_m: number | string | null;
+    max_development_intensity: number | string | null;
+    max_built_up_coverage_pct: number | string | null;
+    min_bio_active_area_pct: number | string | null;
+    params_mixed: boolean;
+    effective_from: string | null;
+}
+export interface PlanningResponse {
+    data: PlanningRow[];
+    truncated: boolean;
+    coverage: "covered" | "covered_no_data" | "not_covered";
+    parcels_total: number;
+    parcels_covered: number;
+    note: string | null;
+}
+export declare function getTransactionPlanning(transactionId: string, apiKey?: string): Promise<ApiResponse<PlanningResponse>>;
+export interface FarmlandRow {
+    eligible_area_m2: number;
+    pct_of_parcel: number | null;
+    feature_count: number;
+}
+export interface FarmlandResponse {
+    data: FarmlandRow[];
+    truncated: boolean;
+    parcels_total: number;
+    parcels_with_data: number;
+    as_of: string | null;
+}
+export declare function getTransactionFarmland(transactionId: string, apiKey?: string): Promise<ApiResponse<FarmlandResponse>>;