Skip to main content
GET
/
stage3
/
development-projects
/
{projectId}
/
{cimFile}
Retrieve individual CIM XML Difference Model file from a Development Project
curl --request GET \
  --url https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}
import requests

url = "https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://ltds.{licenceArea}.example.com/grid-modelling/stage3/development-projects/{projectId}/{cimFile}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "header": {
    "mRID": "39132026-9039-4a3f-9961-71F5529CEAA1",
    "created": "2026-05-01T10:35:00.000Z",
    "scenarioTime": "2028-03-01T00:00:00.000Z",
    "modelingAuthoritySet": "EPN",
    "profile": [
      "http://iec.ch/TC57/ns/CIM/CoreEquipment-EU/3.0"
    ],
    "description": "New 132kV substation and feeder additions – Project PROJ-NE-2026A",
    "version": "1.0",
    "dependentOn": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ]
  },
  "forwardDifferences": [
    {
      "mRID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "cim:ACLineSegment",
      "name": "LINE-132-ALPHA-BETA",
      "description": "<string>",
      "attributes": {
        "cim:ACLineSegment.r": 0.1,
        "cim:ACLineSegment.x": 0.4,
        "cim:ACLineSegment.bch": 0,
        "gb:ACLineSegment.ratedU": 132000
      },
      "associations": {
        "cim:ConductingEquipment.BaseVoltage": "d9e8f7c6-b5a4-3210-fedc-ba9876543210"
      }
    }
  ],
  "reverseDifferences": [
    {
      "mRID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "cim:ACLineSegment",
      "name": "LINE-132-ALPHA-BETA",
      "description": "<string>",
      "attributes": {
        "cim:ACLineSegment.r": 0.1,
        "cim:ACLineSegment.x": 0.4,
        "cim:ACLineSegment.bch": 0,
        "gb:ACLineSegment.ratedU": 132000
      },
      "associations": {
        "cim:ConductingEquipment.BaseVoltage": "d9e8f7c6-b5a4-3210-fedc-ba9876543210"
      }
    }
  ]
}
{
  "code": 404,
  "message": "Publication not found for the specified licence area, year and period."
}

Path Parameters

​
projectId
string
required
Maximum string length: 24
​
cimFile
enum<string>
required

CIM XML Difference Model file within a Development Project archive

Available options:
EQ.xml,
SC.xml,
GL.xml
Example:

"EQ.xml"

Query Parameters

​
publicationYear
integer
required

4-digit calendar year of the LTDS publication

Example:

2026

​
period
enum<string>
required

2-digit publication cycle number within the year. 01 = May publication cycle; 02 = November publication cycle.

Available options:
01,
02
Example:

"01"

​
version
integer
default:1

Version number of the .zip file. Starts at 1 for the initial publication; incremented by 1 for each correction within the cycle. Independent of md:Model.version inside the CIM XML files.

Required range: x >= 1
Example:

1

Response

CIM XML Difference Model file (RDF/XML)

A CIM XML Difference Model file serialised as RDF/XML (IEC 61970-552). Describes grid changes as additions (forwardDifferences) and deletions (reverseDifferences) against a base Full Model. RDF namespaces used: - md: http://iec.ch/TC57/61970-552/ModelDescription/1# - dm: http://iec.ch/TC57/61970-552/DifferenceModel/1# - cim: http://iec.ch/TC57/CIM100# - eu: http://iec.ch/TC57/CIM100-European# - gb: http://ofgem.gov.uk/ns/CIM/LTDS/Extensions# - rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#

​
header
object
required

dm:DifferenceModel header as defined in IEC 61970-552 and the LTDS Header Profile. Appears at the beginning of every CIM XML Difference Model file.

​
forwardDifferences
object[]

Grid objects/attributes/associations to be ADDED to the base Full Model

​
reverseDifferences
object[]

Grid objects/attributes/associations to be DELETED from the base Full Model

Last modified on April 15, 2026