# Create Site Measurements

`POST /utility_scale_sites/{resource_id}/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.

## Parameters

### Path Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `resource_id` | string | yes |  |

## Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `measurement` | object | no | A measurement record submitted for an Advanced PV Power site. |
| `measurements` | ApiPvUtilityMeasurement[] | no | Array of measurement records (1-1000). |

## Example request

### cURL

```bash
curl -X POST "https://api.solcast.com.au/utility_scale_sites/{resource_id}/measurements" \
  -H "Authorization: Bearer $API_KEY"
```

### Python

```python
import requests

response = requests.post(
    "https://api.solcast.com.au/utility_scale_sites/{resource_id}/measurements",
    headers={"Authorization": "Bearer API_KEY"},
)
data = response.json()
```

## Example response (200)

```json
{
  "site_resource_id": "a144b308-6581-4924-9cc6-2e5b584a6bde",
  "measurement": {
    "period_end": "2024-07-01T00:00:00.0000000Z",
    "period": "string",
    "total_power": 1,
    "availability": 1,
    "mean_ghi": 42,
    "tracking_angle": 42,
    "network_constraint": true,
    "constraint_power_ceiling": 1,
    "local_limit": 1,
    "frequency": 1
  },
  "measurements": [
    {
      "period_end": "2024-07-01T00:00:00.0000000Z",
      "period": "string",
      "total_power": 1,
      "availability": 1,
      "mean_ghi": 42,
      "tracking_angle": 42,
      "network_constraint": true,
      "constraint_power_ceiling": 1,
      "local_limit": 1,
      "frequency": 1
    }
  ],
  "response_status": {
    "error_code": "string",
    "message": "string",
    "stack_trace": "string",
    "errors": [
      {
        "error_code": null,
        "field_name": null,
        "message": null,
        "meta": null
      }
    ],
    "meta": {}
  }
}
```

## Responses

### 200 — OK

Schema: `CreatePvUtilityMeasurementResponse`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `site_resource_id` | string | no |  |
| `measurement` | string | no |  |
| `measurements` | ApiPvUtilityMeasurement[] | no |  |
| `response_status` | string | no |  |

Source: /docs/section/advanced-pv-power#postUtilityScaleSitesByResourceIdMeasurements