📊 Price Upload API Documentation

Overview

The TRACE Price Upload API allows you to upload different types of energy tariff offers to the system using JSON files. The API supports multiple tariff types, each with its own specific format and requirements.

This documentation is organized by tariff type to help you quickly find the information you need.

Available Tariff Types

Direct Marketing Tariffs

Upload direct marketing tariff offers with capacity tiers and flexible pricing structures.

Features:

Multiple technology types (Solar, Wind)
Capacity tier configuration
EEG and Market Value pricing
Spot and fixed fee structures

Endpoint: POST /tariff-management/direct-marketing/upload

View Direct Marketing Documentation →

PPA Tariffs (Upstream & Downstream)

Upload Power Purchase Agreement offers for buying or selling energy.

Features:

Upstream (selling) and Downstream (buying) contracts
Multiple technologies (Solar, Wind, Biomass)
Quarterly or yearly pricing
Guarantee of Origin handling
Flexible payment structures

Endpoint: POST /tariff-management/ppa/upload

View PPA Documentation →

Quick Start Guide

Choose your tariff type from the options above
Review the documentation for your chosen tariff type
Prepare your JSON file according to the format specifications
Upload using the API endpoint with proper authentication
Verify the results in the response

Common Features

All tariff upload endpoints share these common features:

Authentication

All endpoints require authentication using a Bearer token:

Authorization: Bearer YOUR_TOKEN

File Format

Content-Type: multipart/form-data
File Format: JSON
Encoding: UTF-8

Response Format

All endpoints return a standardized response:

{
  "success": true,
  "results": [
    {
      "offerId": "guid",
      "success": true,
      "message": "Imported successfully"
    }
  ]
}

Error Handling

200 OK - Successful upload
400 Bad Request - Invalid request or file format
401 Unauthorized - Missing or invalid authentication
500 Internal Server Error - Server error during processing

Getting Help

If you encounter issues:

Check the specific tariff type documentation for detailed requirements
Validate your JSON file format
Review error messages in the API response
Contact the TRACE development team for support

API Versions

Current API Version: V8

The API automatically detects the tariff type based on the JSON structure. Make sure to follow the correct format for your tariff type as specified in the respective documentation pages.