---
title: "Create Site Measurements"
method: POST
path: "/utility_scale_sites/{ResourceId}/measurements"
tags: ["Resources", "Advanced PV Power"]
---

# Create Site Measurements

`POST /utility_scale_sites/{ResourceId}/measurements`

Submit measurement data for an Advanced PV Power site. You can submit a single measurement, or an array of measurements. Maximum 1000 measurements per request.

## Path parameters

- `ResourceId` string, required — The unique identifier of the Advanced PV Power resource.

## Request body

- CreatePvUtilityMeasurement — Create Site Measurements
  - `ResourceId` string, required — The unique identifier of the Advanced PV Power resource.
  - `measurement` ApiPvUtilityMeasurement — A measurement record submitted for an Advanced PV Power site.
    - `period_end` string, date-time, required — End of the measurement period (ISO-8601 with timezone, exclusive).
    - `period` string — Duration of the measurement period (ISO-8601 duration, e.g., PT5M). Either 'period' or 'period_start' required.
    - `total_power` number, double — Power output in MW.
    - `availability` number, double, nullable — Availability percentage (0-100).
    - `mean_ghi` integer, nullable — Mean global horizontal irradiance for the measurement period, in W/m².
    - `tracking_angle` integer, nullable — Tracking angle applied during the measurement period, in degrees.
    - `network_constraint` boolean, nullable — Whether a network constraint affected the measurement period.
    - `constraint_power_ceiling` number, double, nullable — Power ceiling imposed by a network constraint, in MW.
    - `local_limit` number, double, nullable — Local power limit applied during the measurement period, in MW.
    - `frequency` number, double, nullable — Grid frequency during the measurement period, in Hz.
  - `measurements` ApiPvUtilityMeasurement[] — Array of measurement records (1-1000).
    - `period_end` string, date-time, required — End of the measurement period (ISO-8601 with timezone, exclusive).
    - `period` string — Duration of the measurement period (ISO-8601 duration, e.g., PT5M). Either 'period' or 'period_start' required.
    - `total_power` number, double — Power output in MW.
    - `availability` number, double, nullable — Availability percentage (0-100).
    - `mean_ghi` integer, nullable — Mean global horizontal irradiance for the measurement period, in W/m².
    - `tracking_angle` integer, nullable — Tracking angle applied during the measurement period, in degrees.
    - `network_constraint` boolean, nullable — Whether a network constraint affected the measurement period.
    - `constraint_power_ceiling` number, double, nullable — Power ceiling imposed by a network constraint, in MW.
    - `local_limit` number, double, nullable — Local power limit applied during the measurement period, in MW.
    - `frequency` number, double, nullable — Grid frequency during the measurement period, in Hz.

## Response `200`

OK

- CreatePvUtilityMeasurementResponse
  - `site_resource_id` string, nullable
  - `measurement` ApiPvUtilityMeasurement — A measurement record submitted for an Advanced PV Power site.
    - `period_end` string, date-time, required — End of the measurement period (ISO-8601 with timezone, exclusive).
    - `period` string — Duration of the measurement period (ISO-8601 duration, e.g., PT5M). Either 'period' or 'period_start' required.
    - `total_power` number, double — Power output in MW.
    - `availability` number, double, nullable — Availability percentage (0-100).
    - `mean_ghi` integer, nullable — Mean global horizontal irradiance for the measurement period, in W/m².
    - `tracking_angle` integer, nullable — Tracking angle applied during the measurement period, in degrees.
    - `network_constraint` boolean, nullable — Whether a network constraint affected the measurement period.
    - `constraint_power_ceiling` number, double, nullable — Power ceiling imposed by a network constraint, in MW.
    - `local_limit` number, double, nullable — Local power limit applied during the measurement period, in MW.
    - `frequency` number, double, nullable — Grid frequency during the measurement period, in Hz.
  - `measurements` ApiPvUtilityMeasurement[], nullable
    - `period_end` string, date-time, required — End of the measurement period (ISO-8601 with timezone, exclusive).
    - `period` string — Duration of the measurement period (ISO-8601 duration, e.g., PT5M). Either 'period' or 'period_start' required.
    - `total_power` number, double — Power output in MW.
    - `availability` number, double, nullable — Availability percentage (0-100).
    - `mean_ghi` integer, nullable — Mean global horizontal irradiance for the measurement period, in W/m².
    - `tracking_angle` integer, nullable — Tracking angle applied during the measurement period, in degrees.
    - `network_constraint` boolean, nullable — Whether a network constraint affected the measurement period.
    - `constraint_power_ceiling` number, double, nullable — Power ceiling imposed by a network constraint, in MW.
    - `local_limit` number, double, nullable — Local power limit applied during the measurement period, in MW.
    - `frequency` number, double, nullable — Grid frequency during the measurement period, in Hz.
  - `response_status` ResponseStatus
    - `error_code` string, nullable
    - `message` string, nullable
    - `stack_trace` string, nullable
    - `errors` ResponseError[], nullable
      - `error_code` string, nullable
      - `field_name` string, nullable
      - `message` string, nullable
      - `meta` object, nullable
    - `meta` object, nullable

---

[API](https://skmtc.net/solcast/apis/solcast-api.md) · [All operations](https://skmtc.net/solcast/apis/solcast-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solcast/solcast-api/revisions/591461e66c79/schema)