@vepler/sdk 2.39.0 → 2.45.0

package/src/sdk/models/operations/getenergyforproperty.ts

@@ -0,0 +1,1076 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetEnergyForPropertyRequest = {
+  /**
+   * Comma-separated list of layers to include in the response. Available layers: supplyArea, substation, capacity, ecr, dfes, connections. Defaults to all layers if omitted
+   */
+  include?: string | undefined;
+  /**
+   * Latitude of the property location (WGS84)
+   */
+  lat?: number | null | undefined;
+  locationId: string;
+  /**
+   * Longitude of the property location (WGS84)
+   */
+  lon?: number | null | undefined;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyObject = {
+  CapacitySnapshot: "capacity_snapshot",
+} as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyObject = ClosedEnum<
+  typeof GetEnergyForPropertyEnergyObject
+>;
+
+/**
+ * A quarterly snapshot of substation capacity and headroom. Use these to track how available capacity changes over time
+ */
+export type CapacitySnapshot = {
+  /**
+   * Battery-specific headroom, in megawatts (MW). Only available from some operators
+   */
+  batteryHeadroomMw: number | null;
+  /**
+   * Available demand headroom at this snapshot date, in megawatts (MW)
+   */
+  demandHeadroomMw: number | null;
+  /**
+   * Peak demand at this snapshot date, in megawatts (MW)
+   */
+  demandMw: number | null;
+  /**
+   * Electric vehicle charger-specific headroom, in megawatts (MW). Only available from some operators
+   */
+  evHeadroomMw: number | null;
+  /**
+   * Firm capacity rating at this snapshot date, in megawatts (MW)
+   */
+  firmCapacityMw: number | null;
+  /**
+   * Available generation headroom at this snapshot date, in megawatts (MW)
+   */
+  generationHeadroomMw: number | null;
+  /**
+   * Object type identifier
+   */
+  object: GetEnergyForPropertyEnergyObject;
+  /**
+   * Date of this capacity snapshot, typically the start of a quarter (ISO 8601)
+   */
+  snapshotDate: string;
+  /**
+   * Identifier for the data source this snapshot was extracted from
+   */
+  snapshotSource: string;
+  /**
+   * Solar-specific headroom, in megawatts (MW). Only available from some operators
+   */
+  solarHeadroomMw: number | null;
+  /**
+   * Code of the substation this snapshot belongs to
+   */
+  substationCode: string;
+  /**
+   * Utilisation percentage at this snapshot date
+   */
+  utilisationPct: number | null;
+};
+
+/**
+ * WGS84 coordinate pair
+ */
+export type GetEnergyForPropertyCoordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyResponseObject = {
+  ConnectionQueueEntry: "connection_queue_entry",
+} as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyResponseObject = ClosedEnum<
+  typeof GetEnergyForPropertyEnergyResponseObject
+>;
+
+/**
+ * A technology component of a multi-technology connection queue entry
+ */
+export type GetEnergyForPropertyConnectionQueueTechnology = {
+  /**
+   * Capacity allocated to this technology, in megawatts (MW)
+   */
+  capacityMw: number | null;
+  /**
+   * Whether this is the primary technology for the project
+   */
+  isPrimary: boolean;
+  /**
+   * Technology grouping (generation, storage, thermal, demand, infrastructure, other)
+   */
+  technologyCategory: string | null;
+  /**
+   * Canonical technology type from the shared taxonomy
+   */
+  technologyType: string;
+};
+
+/**
+ * An entry from the national grid connection queue — representing a project awaiting or holding a connection agreement to the electricity network. Covers both transmission (TEC Register) and distribution (Embedded Register) connections
+ */
+export type GetEnergyForPropertyConnectionQueueEntry = {
+  /**
+   * Date the connection offer was accepted (ISO 8601)
+   */
+  acceptanceDate: string | null;
+  /**
+   * Date the connection application was submitted (ISO 8601)
+   */
+  applicationDate: string | null;
+  /**
+   * Total connection capacity, in megawatts (MW)
+   */
+  capacityMw: number | null;
+  /**
+   * Agreed or expected connection date (ISO 8601)
+   */
+  connectionDate: string | null;
+  /**
+   * Raw connection site name from the source register
+   */
+  connectionSite: string | null;
+  /**
+   * Canonical connection lifecycle status
+   */
+  connectionStatus: string | null;
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Cumulative capacity of all projects ahead in the queue, in megawatts (MW)
+   */
+  cumulativeCapacityMw: number | null;
+  /**
+   * Name of the connecting customer or developer
+   */
+  customerName: string | null;
+  /**
+   * Maximum export capacity, in megawatts (MW)
+   */
+  exportCapacityMw: number | null;
+  /**
+   * Maximum import capacity, in megawatts (MW)
+   */
+  importCapacityMw: number | null;
+  /**
+   * WGS84 coordinate pair
+   */
+  location: GetEnergyForPropertyCoordinates | null;
+  /**
+   * Network voltage level: transmission, distribution, or interconnector
+   */
+  networkLevel: string | null;
+  /**
+   * Object type identifier
+   */
+  object: GetEnergyForPropertyEnergyResponseObject;
+  /**
+   * Date the connection offer was made (ISO 8601)
+   */
+  offerDate: string | null;
+  /**
+   * Licence area or operating region
+   */
+  operatingRegion: string | null;
+  /**
+   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   */
+  operator: string;
+  /**
+   * Unique project identifier from the source register
+   */
+  projectId: string;
+  /**
+   * Human-readable project name
+   */
+  projectName: string | null;
+  /**
+   * Secondary project reference number
+   */
+  projectNumber: string | null;
+  /**
+   * Position in the connection queue, if available
+   */
+  queuePosition: number | null;
+  /**
+   * Source register identifier (e.g. neso_tec, neso_embedded)
+   */
+  sourceDataset: string;
+  /**
+   * Code of the resolved substation, if matched
+   */
+  substationCode: string | null;
+  /**
+   * All technology components for multi-technology projects
+   */
+  technologies?:
+    | Array<GetEnergyForPropertyConnectionQueueTechnology>
+    | undefined;
+  /**
+   * Primary technology category
+   */
+  technologyCategory: string | null;
+  /**
+   * Primary canonical technology type
+   */
+  technologyType: string | null;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyResponse200Object = {
+  DfesForecast: "dfes_forecast",
+} as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyResponse200Object = ClosedEnum<
+  typeof GetEnergyForPropertyEnergyResponse200Object
+>;
+
+/**
+ * A forecast from an energy planning framework (e.g. DFES in GB), projecting future demand, generation, and storage capacity under different energy transition pathways
+ */
+export type DfesForecast = {
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Forecast value, in megawatts (MW), for this scenario, year, and technology
+   */
+  forecastMw: number | null;
+  /**
+   * Category of a forecast. Known values: 'demand', 'generation', 'storage'. 'demand' forecasts electricity consumption growth. 'generation' forecasts new renewable/distributed generation capacity. 'storage' forecasts battery and other storage deployment. New categories can be added as energy models evolve (e.g. flexibility, hydrogen).
+   */
+  forecastType: string;
+  /**
+   * Object type identifier
+   */
+  object: GetEnergyForPropertyEnergyResponse200Object;
+  /**
+   * Operating region this forecast applies to
+   */
+  operatingRegion: string;
+  /**
+   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   */
+  operator: string;
+  /**
+   * Energy planning scenario identifier. Each country's energy planning framework defines its own scenarios. Known GB scenarios: 'leading_the_way', 'consumer_transformation', 'system_transformation', 'falling_short', 'best_view', 'holistic_transition'. 'leading_the_way' assumes fastest decarbonisation. 'falling_short' assumes slowest progress. 'best_view' is the operator's most likely central estimate.
+   */
+  scenario: string;
+  /**
+   * Code of the substation this forecast applies to, if substation-level
+   */
+  substationCode: string | null;
+  /**
+   * Technology type being forecast (e.g. solar, EV, heat pump, battery)
+   */
+  technologyType: string | null;
+  /**
+   * Forecast year
+   */
+  year: number;
+};
+
+/**
+ * WGS84 coordinate pair
+ */
+export type GetEnergyForPropertyEnergyCoordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONObject = {
+  EcrEntry: "ecr_entry",
+} as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyResponse200ApplicationJSONObject =
+  ClosedEnum<typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONObject>;
+
+/**
+ * An entry from the Embedded Capacity Register (ECR) — a public record of all generation and storage connections to the distribution network
+ */
+export type EcrEntry = {
+  /**
+   * Unique identifier for this ECR entry
+   */
+  code: string;
+  /**
+   * Date the connection was made or is expected (ISO 8601)
+   */
+  connectionDate: string | null;
+  /**
+   * Lifecycle status of a generation/storage connection. Known values: 'connected', 'accepted', 'contracted', 'in_scoping'. 'connected' is live and exporting. 'accepted' has a formal connection offer accepted. 'contracted' is under contract but not yet connected. 'in_scoping' is in early feasibility assessment. Different regulatory frameworks may define additional statuses.
+   */
+  connectionStatus: string | null;
+  /**
+   * Category of an embedded capacity register connection. Known values: 'generation', 'storage', 'generation_and_storage'. 'generation' covers solar, wind, gas, biomass, etc. 'storage' covers batteries. 'generation_and_storage' covers co-located sites. New types can be added as technologies evolve (e.g. hydrogen electrolysis, V2G).
+   */
+  connectionType: string | null;
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Maximum export capacity agreed with the network operator, in megawatts (MW)
+   */
+  exportCapacityMw: number | null;
+  /**
+   * Total installed capacity of the connection, in megawatts (MW)
+   */
+  installedCapacityMw: number | null;
+  /**
+   * WGS84 coordinate pair
+   */
+  location: GetEnergyForPropertyEnergyCoordinates | null;
+  /**
+   * Object type identifier
+   */
+  object: GetEnergyForPropertyEnergyResponse200ApplicationJSONObject;
+  /**
+   * Operating region where this connection is located
+   */
+  operatingRegion: string | null;
+  /**
+   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   */
+  operator: string;
+  /**
+   * Code of the substation this connection is registered against
+   */
+  substationCode: string | null;
+  /**
+   * Technology used for generation or storage (e.g. solar, wind, battery, gas, biomass)
+   */
+  technologyType: string | null;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyObject = {
+  EnergyForProperty: "energy_for_property",
+} as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyObject = ClosedEnum<
+  typeof GetEnergyForPropertyObject
+>;
+
+/**
+ * WGS84 coordinate pair
+ */
+export type GetEnergyForPropertyEnergyResponseCoordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject =
+  {
+    Substation: "substation",
+  } as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject =
+  ClosedEnum<
+    typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject
+  >;
+
+/**
+ * A network operator substation with its current capacity and headroom data
+ */
+export type GetEnergyForPropertySubstation = {
+  /**
+   * Unique substation identifier, prefixed with the operator code
+   */
+  code: string;
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Available spare capacity for new demand connections, in megawatts (MW). Calculated as firm capacity minus peak demand
+   */
+  demandHeadroomMw: number | null;
+  /**
+   * Current peak electricity demand at this substation, in megawatts (MW)
+   */
+  demandMw: number | null;
+  /**
+   * Maximum firm capacity rating, in megawatts (MW). This is the guaranteed capacity available under all operating conditions
+   */
+  firmCapacityMw: number | null;
+  /**
+   * Available spare capacity for new generation connections (e.g. solar, wind), in megawatts (MW)
+   */
+  generationHeadroomMw: number | null;
+  /**
+   * WGS84 coordinate pair
+   */
+  location: GetEnergyForPropertyEnergyResponseCoordinates | null;
+  /**
+   * Human-readable substation name, where available
+   */
+  name: string | null;
+  /**
+   * Object type identifier
+   */
+  object:
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject;
+  /**
+   * Operating region name (e.g. 'UKPN (SPN)' in GB, or region name in other countries)
+   */
+  operatingRegion: string | null;
+  /**
+   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   */
+  operator: string;
+  /**
+   * Code of the parent substation in the network hierarchy (e.g. a primary's parent grid substation). Null for top-level GSPs
+   */
+  parentSubstationCode: string | null;
+  /**
+   * Maximum capacity for reverse power flow (generation exceeding local demand), in megawatts (MW)
+   */
+  reversePowerCapacityMw: number | null;
+  /**
+   * Classification of substation within the electricity network hierarchy. Known values: 'gsp', 'bulk_supply', 'grid', 'primary', 'distribution'. 'gsp' (Grid Supply Point) connects to the national transmission grid. 'bulk_supply' and 'grid' operate at intermediate voltages. 'primary' steps down to 11kV for local distribution. 'distribution' serves end customers at low voltage.
+   */
+  substationType: string | null;
+  /**
+   * Current utilisation as a percentage of firm capacity. Higher values indicate less available headroom
+   */
+  utilisationPct: number | null;
+  /**
+   * Operating voltage, in kilovolts (kV)
+   */
+  voltageKv: number | null;
+};
+
+/**
+ * WGS84 coordinate pair
+ */
+export type GetEnergyForPropertyEnergyResponse200Coordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * Object type identifier
+ */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject =
+  {
+    SupplyArea: "supply_area",
+  } as const;
+/**
+ * Object type identifier
+ */
+export type GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject =
+  ClosedEnum<
+    typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject
+  >;
+
+/**
+ * A geographic boundary defining the area served by a specific substation
+ */
+export type GetEnergyForPropertySupplyArea = {
+  /**
+   * Area of the supply boundary in square kilometres
+   */
+  areaSqkm: number | null;
+  /**
+   * Classification of supply area boundary. Each type corresponds to a level in the network hierarchy. Known values: 'gsp', 'bsp', 'grid', 'primary', 'distribution'. 'distribution' is the most granular, 'gsp' (Grid Supply Point) is the broadest.
+   */
+  areaType: string | null;
+  /**
+   * WGS84 coordinate pair
+   */
+  centroid: GetEnergyForPropertyEnergyResponse200Coordinates | null;
+  /**
+   * Unique supply area identifier, prefixed with the operator code
+   */
+  code: string;
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Human-readable supply area name, where available
+   */
+  name: string | null;
+  /**
+   * Object type identifier
+   */
+  object:
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject;
+  /**
+   * Operating region name
+   */
+  operatingRegion: string | null;
+  /**
+   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   */
+  operator: string;
+  /**
+   * Code of the substation that serves this supply area
+   */
+  substationCode: string | null;
+};
+
+/**
+ * Complete energy infrastructure context for a property location. Resolves the property coordinates to its serving supply area and substation, then enriches with capacity history, registered connections, and future energy forecasts. Use the `include` query parameter to select which layers to return (defaults to all). If a layer is requested via `include` but no data exists for the property's location, that field will be `null` (not omitted from the response)
+ */
+export type GetEnergyForPropertyEnergyForProperty = {
+  /**
+   * Historical quarterly capacity snapshots for the serving substation, ordered chronologically. Omitted if not requested via `include`
+   */
+  capacitySnapshots?: Array<CapacitySnapshot> | undefined;
+  /**
+   * Grid connection queue entries at or near the serving substation. Omitted if not requested via `include`
+   */
+  connectionQueueEntries?:
+    | Array<GetEnergyForPropertyConnectionQueueEntry>
+    | undefined;
+  /**
+   * ISO 3166-1 alpha-2 country code, derived from the resolved operator. Null if no infrastructure was resolved
+   */
+  country: string | null;
+  /**
+   * Future energy scenario forecasts for the serving substation. Omitted if not requested via `include`
+   */
+  dfesForecasts?: Array<DfesForecast> | undefined;
+  /**
+   * Generation and storage connections registered at or near the serving substation. Omitted if not requested via `include`
+   */
+  ecrEntries?: Array<EcrEntry> | undefined;
+  /**
+   * Unique location identifier (e.g. UPRN in the UK)
+   */
+  locationId: string;
+  /**
+   * Object type identifier
+   */
+  object: GetEnergyForPropertyObject;
+  /**
+   * A network operator substation with its current capacity and headroom data
+   */
+  substation?: GetEnergyForPropertySubstation | null | undefined;
+  /**
+   * A geographic boundary defining the area served by a specific substation
+   */
+  supplyArea?: GetEnergyForPropertySupplyArea | null | undefined;
+};
+
+/** @internal */
+export type GetEnergyForPropertyRequest$Outbound = {
+  include?: string | undefined;
+  lat?: number | null | undefined;
+  locationId: string;
+  lon?: number | null | undefined;
+};
+
+/** @internal */
+export const GetEnergyForPropertyRequest$outboundSchema: z.ZodType<
+  GetEnergyForPropertyRequest$Outbound,
+  z.ZodTypeDef,
+  GetEnergyForPropertyRequest
+> = z.object({
+  include: z.string().optional(),
+  lat: z.nullable(z.number()).optional(),
+  locationId: z.string(),
+  lon: z.nullable(z.number()).optional(),
+});
+
+export function getEnergyForPropertyRequestToJSON(
+  getEnergyForPropertyRequest: GetEnergyForPropertyRequest,
+): string {
+  return JSON.stringify(
+    GetEnergyForPropertyRequest$outboundSchema.parse(
+      getEnergyForPropertyRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyObject$inboundSchema: z.ZodNativeEnum<
+  typeof GetEnergyForPropertyEnergyObject
+> = z.nativeEnum(GetEnergyForPropertyEnergyObject);
+
+/** @internal */
+export const CapacitySnapshot$inboundSchema: z.ZodType<
+  CapacitySnapshot,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  batteryHeadroomMw: z.nullable(z.number()),
+  demandHeadroomMw: z.nullable(z.number()),
+  demandMw: z.nullable(z.number()),
+  evHeadroomMw: z.nullable(z.number()),
+  firmCapacityMw: z.nullable(z.number()),
+  generationHeadroomMw: z.nullable(z.number()),
+  object: GetEnergyForPropertyEnergyObject$inboundSchema,
+  snapshotDate: z.string(),
+  snapshotSource: z.string(),
+  solarHeadroomMw: z.nullable(z.number()),
+  substationCode: z.string(),
+  utilisationPct: z.nullable(z.number()),
+});
+
+export function capacitySnapshotFromJSON(
+  jsonString: string,
+): SafeParseResult<CapacitySnapshot, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CapacitySnapshot$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CapacitySnapshot' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyCoordinates$inboundSchema: z.ZodType<
+  GetEnergyForPropertyCoordinates,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  lat: z.number(),
+  lng: z.number(),
+});
+
+export function getEnergyForPropertyCoordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetEnergyForPropertyCoordinates, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetEnergyForPropertyCoordinates$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetEnergyForPropertyCoordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponseObject$inboundSchema:
+  z.ZodNativeEnum<typeof GetEnergyForPropertyEnergyResponseObject> = z
+    .nativeEnum(GetEnergyForPropertyEnergyResponseObject);
+
+/** @internal */
+export const GetEnergyForPropertyConnectionQueueTechnology$inboundSchema:
+  z.ZodType<
+    GetEnergyForPropertyConnectionQueueTechnology,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    capacityMw: z.nullable(z.number()),
+    isPrimary: z.boolean(),
+    technologyCategory: z.nullable(z.string()),
+    technologyType: z.string(),
+  });
+
+export function getEnergyForPropertyConnectionQueueTechnologyFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GetEnergyForPropertyConnectionQueueTechnology,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyConnectionQueueTechnology$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GetEnergyForPropertyConnectionQueueTechnology' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyConnectionQueueEntry$inboundSchema: z.ZodType<
+  GetEnergyForPropertyConnectionQueueEntry,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  acceptanceDate: z.nullable(z.string()),
+  applicationDate: z.nullable(z.string()),
+  capacityMw: z.nullable(z.number()),
+  connectionDate: z.nullable(z.string()),
+  connectionSite: z.nullable(z.string()),
+  connectionStatus: z.nullable(z.string()),
+  country: z.string(),
+  cumulativeCapacityMw: z.nullable(z.number()),
+  customerName: z.nullable(z.string()),
+  exportCapacityMw: z.nullable(z.number()),
+  importCapacityMw: z.nullable(z.number()),
+  location: z.nullable(
+    z.lazy(() => GetEnergyForPropertyCoordinates$inboundSchema),
+  ),
+  networkLevel: z.nullable(z.string()),
+  object: GetEnergyForPropertyEnergyResponseObject$inboundSchema,
+  offerDate: z.nullable(z.string()),
+  operatingRegion: z.nullable(z.string()),
+  operator: z.string(),
+  projectId: z.string(),
+  projectName: z.nullable(z.string()),
+  projectNumber: z.nullable(z.string()),
+  queuePosition: z.nullable(z.number()),
+  sourceDataset: z.string(),
+  substationCode: z.nullable(z.string()),
+  technologies: z.array(
+    z.lazy(() => GetEnergyForPropertyConnectionQueueTechnology$inboundSchema),
+  ).optional(),
+  technologyCategory: z.nullable(z.string()),
+  technologyType: z.nullable(z.string()),
+});
+
+export function getEnergyForPropertyConnectionQueueEntryFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GetEnergyForPropertyConnectionQueueEntry,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyConnectionQueueEntry$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GetEnergyForPropertyConnectionQueueEntry' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponse200Object$inboundSchema:
+  z.ZodNativeEnum<typeof GetEnergyForPropertyEnergyResponse200Object> = z
+    .nativeEnum(GetEnergyForPropertyEnergyResponse200Object);
+
+/** @internal */
+export const DfesForecast$inboundSchema: z.ZodType<
+  DfesForecast,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  country: z.string(),
+  forecastMw: z.nullable(z.number()),
+  forecastType: z.string(),
+  object: GetEnergyForPropertyEnergyResponse200Object$inboundSchema,
+  operatingRegion: z.string(),
+  operator: z.string(),
+  scenario: z.string(),
+  substationCode: z.nullable(z.string()),
+  technologyType: z.nullable(z.string()),
+  year: z.number(),
+});
+
+export function dfesForecastFromJSON(
+  jsonString: string,
+): SafeParseResult<DfesForecast, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DfesForecast$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DfesForecast' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyCoordinates$inboundSchema: z.ZodType<
+  GetEnergyForPropertyEnergyCoordinates,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  lat: z.number(),
+  lng: z.number(),
+});
+
+export function getEnergyForPropertyEnergyCoordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetEnergyForPropertyEnergyCoordinates, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyEnergyCoordinates$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetEnergyForPropertyEnergyCoordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONObject$inboundSchema:
+  z.ZodNativeEnum<
+    typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONObject
+  > = z.nativeEnum(GetEnergyForPropertyEnergyResponse200ApplicationJSONObject);
+
+/** @internal */
+export const EcrEntry$inboundSchema: z.ZodType<
+  EcrEntry,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  code: z.string(),
+  connectionDate: z.nullable(z.string()),
+  connectionStatus: z.nullable(z.string()),
+  connectionType: z.nullable(z.string()),
+  country: z.string(),
+  exportCapacityMw: z.nullable(z.number()),
+  installedCapacityMw: z.nullable(z.number()),
+  location: z.nullable(
+    z.lazy(() => GetEnergyForPropertyEnergyCoordinates$inboundSchema),
+  ),
+  object:
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONObject$inboundSchema,
+  operatingRegion: z.nullable(z.string()),
+  operator: z.string(),
+  substationCode: z.nullable(z.string()),
+  technologyType: z.nullable(z.string()),
+});
+
+export function ecrEntryFromJSON(
+  jsonString: string,
+): SafeParseResult<EcrEntry, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EcrEntry$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EcrEntry' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyObject$inboundSchema: z.ZodNativeEnum<
+  typeof GetEnergyForPropertyObject
+> = z.nativeEnum(GetEnergyForPropertyObject);
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponseCoordinates$inboundSchema:
+  z.ZodType<
+    GetEnergyForPropertyEnergyResponseCoordinates,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    lat: z.number(),
+    lng: z.number(),
+  });
+
+export function getEnergyForPropertyEnergyResponseCoordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GetEnergyForPropertyEnergyResponseCoordinates,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyEnergyResponseCoordinates$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GetEnergyForPropertyEnergyResponseCoordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject$inboundSchema:
+  z.ZodNativeEnum<
+    typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject
+  > = z.nativeEnum(
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject,
+  );
+
+/** @internal */
+export const GetEnergyForPropertySubstation$inboundSchema: z.ZodType<
+  GetEnergyForPropertySubstation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  code: z.string(),
+  country: z.string(),
+  demandHeadroomMw: z.nullable(z.number()),
+  demandMw: z.nullable(z.number()),
+  firmCapacityMw: z.nullable(z.number()),
+  generationHeadroomMw: z.nullable(z.number()),
+  location: z.nullable(
+    z.lazy(() => GetEnergyForPropertyEnergyResponseCoordinates$inboundSchema),
+  ),
+  name: z.nullable(z.string()),
+  object:
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodyObject$inboundSchema,
+  operatingRegion: z.nullable(z.string()),
+  operator: z.string(),
+  parentSubstationCode: z.nullable(z.string()),
+  reversePowerCapacityMw: z.nullable(z.number()),
+  substationType: z.nullable(z.string()),
+  utilisationPct: z.nullable(z.number()),
+  voltageKv: z.nullable(z.number()),
+});
+
+export function getEnergyForPropertySubstationFromJSON(
+  jsonString: string,
+): SafeParseResult<GetEnergyForPropertySubstation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetEnergyForPropertySubstation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetEnergyForPropertySubstation' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponse200Coordinates$inboundSchema:
+  z.ZodType<
+    GetEnergyForPropertyEnergyResponse200Coordinates,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    lat: z.number(),
+    lng: z.number(),
+  });
+
+export function getEnergyForPropertyEnergyResponse200CoordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GetEnergyForPropertyEnergyResponse200Coordinates,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyEnergyResponse200Coordinates$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GetEnergyForPropertyEnergyResponse200Coordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject$inboundSchema:
+  z.ZodNativeEnum<
+    typeof GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject
+  > = z.nativeEnum(
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject,
+  );
+
+/** @internal */
+export const GetEnergyForPropertySupplyArea$inboundSchema: z.ZodType<
+  GetEnergyForPropertySupplyArea,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  areaSqkm: z.nullable(z.number()),
+  areaType: z.nullable(z.string()),
+  centroid: z.nullable(
+    z.lazy(() =>
+      GetEnergyForPropertyEnergyResponse200Coordinates$inboundSchema
+    ),
+  ),
+  code: z.string(),
+  country: z.string(),
+  name: z.nullable(z.string()),
+  object:
+    GetEnergyForPropertyEnergyResponse200ApplicationJSONResponseBodySupplyAreaObject$inboundSchema,
+  operatingRegion: z.nullable(z.string()),
+  operator: z.string(),
+  substationCode: z.nullable(z.string()),
+});
+
+export function getEnergyForPropertySupplyAreaFromJSON(
+  jsonString: string,
+): SafeParseResult<GetEnergyForPropertySupplyArea, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetEnergyForPropertySupplyArea$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetEnergyForPropertySupplyArea' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetEnergyForPropertyEnergyForProperty$inboundSchema: z.ZodType<
+  GetEnergyForPropertyEnergyForProperty,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  capacitySnapshots: z.array(z.lazy(() => CapacitySnapshot$inboundSchema))
+    .optional(),
+  connectionQueueEntries: z.array(
+    z.lazy(() => GetEnergyForPropertyConnectionQueueEntry$inboundSchema),
+  ).optional(),
+  country: z.nullable(z.string()),
+  dfesForecasts: z.array(z.lazy(() => DfesForecast$inboundSchema)).optional(),
+  ecrEntries: z.array(z.lazy(() => EcrEntry$inboundSchema)).optional(),
+  locationId: z.string(),
+  object: GetEnergyForPropertyObject$inboundSchema,
+  substation: z.nullable(
+    z.lazy(() => GetEnergyForPropertySubstation$inboundSchema),
+  ).optional(),
+  supplyArea: z.nullable(
+    z.lazy(() => GetEnergyForPropertySupplyArea$inboundSchema),
+  ).optional(),
+});
+
+export function getEnergyForPropertyEnergyForPropertyFromJSON(
+  jsonString: string,
+): SafeParseResult<GetEnergyForPropertyEnergyForProperty, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetEnergyForPropertyEnergyForProperty$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetEnergyForPropertyEnergyForProperty' from JSON`,
+  );
+}