> ## Documentation Index > Fetch the complete documentation index at: https://docs.nox.energy/llms.txt > Use this file to discover all available pages before exploring further. # Get Fleet Pv Typical Production > Get the fleet level typical production forecast for the whole PV pool associated with your energy supplier account in kWh with 15min granularity. The typical production represents the aggregated production the fleet would have produced under the forecasted weather conditions **if no curtailment had taken place**. It is generated for a given `generation_time` (the moment the forecast was produced) and covers the 15min `time_bucket`s within the requested `start_time` and `end_time` window. This is typically used to quantify the impact of a curtailment event: by comparing the actual (curtailed) production of the fleet against this typical production, you can estimate the amount of power that was curtailed compared to a scenario where no curtailment would have happened. The timestamp (`forecast_time`) refers to the production that happens in the next 15 minutes after the timestamp. All timestamps are in UTC. ## OpenAPI ````yaml /api-docs/pv/openapi-pv.json get /v1/fleet/pv/production/typical-production openapi: 3.1.0 info: title: NOX Energy API - PV description: > # PV API Documentation This documentation shows only the endpoints available to pv users. ## Authentication 1. Get your API key from [NOX Energy](mailto:support@nox.energy). 2. Include the API key in your API calls with the header: `x-api-key: YOUR_API_KEY`. ## Access Level This documentation is specifically for **pv users** who have access to these endpoints. Base URL: [https://api.nox.energy](https://api.nox.energy) version: 1.0.0 servers: - url: https://api.nox.energy description: Production Server security: - ApiKeyAuth: [] tags: - name: Asset Info description: API to get basic information about your assets. - name: User Management description: API endpoints to manage users and their data. paths: /v1/fleet/pv/production/typical-production: get: tags: - Device Production summary: Get Fleet Pv Typical Production description: >- Get the fleet level typical production forecast for the whole PV pool associated with your energy supplier account in kWh with 15min granularity. The typical production represents the aggregated production the fleet would have produced under the forecasted weather conditions **if no curtailment had taken place**. It is generated for a given `generation_time` (the moment the forecast was produced) and covers the 15min `time_bucket`s within the requested `start_time` and `end_time` window. This is typically used to quantify the impact of a curtailment event: by comparing the actual (curtailed) production of the fleet against this typical production, you can estimate the amount of power that was curtailed compared to a scenario where no curtailment would have happened. The timestamp (`forecast_time`) refers to the production that happens in the next 15 minutes after the timestamp. All timestamps are in UTC. operationId: >- get_fleet_pv_typical_production_v1_fleet_pv_production_typical_production_get parameters: - name: generation_time in: query required: true schema: type: string description: > The datetime at which the forecast was generated. Only the forecast produced at this exact `generation_time` is returned. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 title: Generation Time description: > The datetime at which the forecast was generated. Only the forecast produced at this exact `generation_time` is returned. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 - name: start_time in: query required: true schema: type: string description: > Start of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the `time_bucket` of the forecast. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 title: Start Time description: > Start of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the `time_bucket` of the forecast. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 - name: end_time in: query required: true schema: type: string description: > End of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the `time_bucket` of the forecast. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 title: End Time description: > End of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the `time_bucket` of the forecast. The time is in UTC in ISO 8601 format. Time format examples: - 2023-10-01T00:00:00Z - 2023-10-01T00:00:00 responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/PVFleetTypicalProductionResponse' example: data: - forecast_time: '2025-05-01T07:45:00.000Z' production: 42.75 - forecast_time: '2025-05-01T08:00:00.000Z' production: 48.1 meta: energy_supplier: Energy Supplier A generation_time: '2025-06-01T07:30:00Z' production_unit: kWh granularity: 15min output_timezone: UTC '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: PVFleetTypicalProductionResponse: properties: data: anyOf: - items: $ref: '#/components/schemas/PVFleetTypicalProductionData' type: array - type: 'null' title: Data description: List of fleet level typical production buckets. meta: anyOf: - $ref: '#/components/schemas/PVFleetTypicalProductionMeta' - type: 'null' description: Response metadata type: object title: PVFleetTypicalProductionResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PVFleetTypicalProductionData: properties: forecast_time: anyOf: - type: string - type: 'null' title: Forecast Time description: Timestamp of the 15min production bucket (start of the interval). production: anyOf: - type: number - type: 'null' title: Production description: >- Fleet level typical production for the bucket in kWh (production without curtailment). type: object title: PVFleetTypicalProductionData PVFleetTypicalProductionMeta: properties: energy_supplier: anyOf: - type: string - type: 'null' title: Energy Supplier description: Energy supplier name. generation_time: anyOf: - type: string - type: 'null' title: Generation Time description: The datetime at which the forecast was generated. production_unit: anyOf: - type: string - type: 'null' title: Production Unit description: Unit of the production values, e.g. kWh. granularity: anyOf: - type: string - type: 'null' title: Granularity description: Granularity of the data. output_timezone: anyOf: - type: string - type: 'null' title: Output Timezone description: Timezone of the output data. type: object title: PVFleetTypicalProductionMeta ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: 'API Key authentication. Enter your API key in the format: YOUR_API_KEY' ````