--- title: "Get grid code parameters and settings" method: GET path: "/grid-code" tags: ["Grid codes"] --- # Get grid code parameters and settings `GET /grid-code` ## Request - Base URL: `http://integrations.api.prod.zaptec.com` - URL: `http://integrations.api.prod.zaptec.com/grid-code` - Auth: HTTP bearer Returns the full grid code state for the charger identified by **`evseId`**. The response includes editable and read-only grid code values. The `metadata` block describes all known fields, including type, unit, precision, range, category, UI grouping, sort order, and whether the field is editable. Use the metadata to render a read-only or edit UI and apply client-side validation without hardcoding field names, grouping, or ordering. ### Read-only fields Some fields returned by GET are not accepted by PUT. Fields with `editable: false` in metadata are read-only for PUT, and fields absent from `metadata` are response-only and also not accepted by PUT. Remove these fields before sending a GET response back as a PUT body. ### See also - `PUT /grid-code` - update editable grid code fields for the charger. ## Query parameters - `evseId` string ## Response `200` OK - GridCodeParametersResponse - `country_code` string - `fuse_limit` union - integer - string, int64 - `dso_max_export_limit` union - integer - string, int64 - `evse_service_unavailable` boolean - `enable_specific_startup_mode` boolean - `enable_startup_function_for_all_services` boolean - `grid_code_settings` GridCodeSettingsResponse - `v_min_normal` union - number, double - string, double - `v_max_normal` union - number, double - string, double - `f_min_normal` union - number, double - string, double - `f_max_normal` union - integer - string, int32 - `active_power_gradient_connection` union - integer - string, int32 - `fnom` union - integer - string, int32 - `vnom` union - integer - string, int32 - `min_rt_u_for_0a` union - number, double - string, double - `max_rt_u_for_0a` union - number, double - string, double - `restore_time_after_fault_rt` union - integer - string, int32 - `under_frequency1_time` union - integer - string, int32 - `uf_rt_stage1` union - number, double - string, double - `under_frequency2_time` union - number, double - string, double - `uf_rt_stage2` union - number, double - string, double - `of_rt_stage1` union - number, double - string, double - `of_rt_stage2` union - number, double - string, double - `over_frequency1_time` union - integer - string, int32 - `over_frequency2_time` union - integer - string, int32 - `rocof_normal` union - number, double - string, double - `rocof_trip_time` union - number, double - string, double - `rocof_measurement_time` union - number, double - string, double - `enable_ov1_prot` boolean - `enable_ov2_prot` boolean - `threshold_over_voltage1_fault` union - number, double - string, double - `time_over_voltage1_fault` union - number, double - string, double - `threshold_over_voltage2_fault` union - number, double - string, double - `time_over_voltage2_fault` union - number, double - string, double - `threshold_over_voltage_10min_fault` union - number, double - string, double - `time_over_voltage_10min_fault` union - number, double - string, double - `enable_10min_ov_prot` boolean - `threshold_under_voltage_fault` union - number, double - string, double - `time_under_voltage_fault` union - number, double - string, double - `threshold_under_voltage1_fault` union - number, double - string, double - `time_under_voltage1_fault` union - number, double - string, double - `enable_uv1_prot` boolean - `threshold_under_voltage2_fault` union - number, double - string, double - `time_under_voltage2_fault` union - number, double - string, double - `enable_uv2_prot` boolean - `threshold_over_frequency_fault` union - number, double - string, double - `time_over_frequency_fault` union - number, double - string, double - `enable_of_prot` boolean - `threshold_over_frequency2_fault` union - number, double - string, double - `time_over_frequency2_fault` union - integer - string, int32 - `threshold_under_frequency1_fault` union - number, double - string, double - `time_under_frequency1_fault` union - number, double - string, double - `enable_uf1_prot` boolean - `threshold_under_frequency2_fault` union - number, double - string, double - `time_under_frequency2_fault` union - number, double - string, double - `enable_uf2_prot` boolean - `rocof_anti_islanding` union - number, double - string, double - `measurement_time_rocof_anti_islanding` union - number, double - string, double - `disconnect_time_anti_islanding` union - number, double - string, double - `max_allowed_unbalance_current` union - number, double - string, double - `observation_time_over_voltage1_fault` union - integer - string, int32 - `enable_auto_reconnect` boolean - `lower_frequency_reconnect` union - number, double - string, double - `upper_frequency_reconnect` union - number, double - string, double - `lower_voltage_reconnect` union - number, double - string, double - `upper_voltage_reconnect` union - number, double - string, double - `obs_time` union - integer - string, int32 - `active_power_gradient_reconnect` union - integer - string, int32 - `enable_lfsm_o` boolean - `threshold_over_frequency` union - number, double - string, double - `droop_over_frequency` union - integer - string, int32 - `min_over_frequency` union - number, double - string, double - `max_over_frequency` union - integer - string, int32 - `intentional_delay_over_frequency` union - number, double - string, double - `responsetime_over_frequency` union - integer - string, int32 - `f_stop_of` union - number, double - string, double - `t_stop_of` union - integer - string, int32 - `enable_lfsm_u` boolean - `max_under_frequency` union - number, double - string, double - `min_under_frequency` union - number, double - string, double - `droop_under_frequency` union - integer - string, int32 - `threshold_under_frequency` union - number, double - string, double - `intentional_delay_under_frequency` union - number, double - string, double - `responsetime_under_frequency` union - integer - string, int32 - `enable_p_red_ov` boolean - `threshold_over_voltage_p_response` union - number, double - string, double - `max_ramp_over_voltage_p_response` union - number, double - string, double - `control_mode` union - integer - string, int32 - `q_set` union - number, double - string, double - `pf_set` union - number, double - string, double - `qu1` union - number, double - string, double - `q_at_qu1` union - number, double - string, double - `qu2` union - number, double - string, double - `q_at_qu2` union - number, double - string, double - `qu3` union - number, double - string, double - `q_at_qu3` union - number, double - string, double - `qu4` union - number, double - string, double - `q_at_qu4` union - number, double - string, double - `qu_lockin` union - integer - string, int32 - `qu_lockout` union - integer - string, int32 - `q_time_constant` union - number, double - string, double - `pfp1` union - integer - string, int32 - `pf_at_p1` union - number, double - string, double - `pfp2` union - integer - string, int32 - `pf_at_p2` union - number, double - string, double - `pfp3` union - integer - string, int32 - `pf_at_p3` union - number, double - string, double - `pfp_lockin` union - number, double - string, double - `pfp_lockout` union - number, double - string, double - `q_at_qu2_unused` union - integer - string, int32 - `q_at_qu3_unused` union - integer - string, int32 - `metadata` GridCodeMetadataResponse: Represents metadata used by clients to render, group, order, and validate grid code fields. - `parameters` object: Gets top-level grid code parameter fields indexed by JSON field name. - `settings` object: Gets grid code settings fields indexed by JSON field name. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `500`: Internal Server Error --- [API](https://skmtc.dev/zaptec/apis/integrationsapi-v1.md) - [All operations](https://skmtc.dev/zaptec/apis/integrationsapi-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zaptec/apis/integrationsapi-v1/revisions/ddbf44002ba0?raw)