Create project
curl --request POST \
--url https://api.emidat.com/v2/projects \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "PRJ-2026-014",
"name": "Tower A",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 120
}
]
}
'import requests
url = "https://api.emidat.com/v2/projects"
payload = {
"external_id": "PRJ-2026-014",
"name": "Tower A",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 120
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'PRJ-2026-014',
name: 'Tower A',
customer_name: 'Bauherr GmbH',
address: {
country: 'DE',
city: 'Munich',
latitude: 48.1351,
longitude: 11.575,
street: 'Musterstraße',
house_number: '12',
postal_code: '80331',
state: 'Bavaria',
formatted_address: 'Musterstraße 12, 80331 Munich, Germany'
},
products: [{product_id: '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b', quantity: 120}]
})
};
fetch('https://api.emidat.com/v2/projects', 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://api.emidat.com/v2/projects",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'PRJ-2026-014',
'name' => 'Tower A',
'customer_name' => 'Bauherr GmbH',
'address' => [
'country' => 'DE',
'city' => 'Munich',
'latitude' => 48.1351,
'longitude' => 11.575,
'street' => 'Musterstraße',
'house_number' => '12',
'postal_code' => '80331',
'state' => 'Bavaria',
'formatted_address' => 'Musterstraße 12, 80331 Munich, Germany'
],
'products' => [
[
'product_id' => '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b',
'quantity' => 120
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emidat.com/v2/projects"
payload := strings.NewReader("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.emidat.com/v2/projects")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/projects")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}Projects
Create project
Creates a project for one of your customers, with at least one line of catalog product and quantity.
A project keeps quantities, not footprints: its gwp_* values are
recalculated from the products’ current LCA results on every read.
Idempotent create — a replay of the same Idempotency-Key returns the
original response (200); otherwise a new project is created (201).
Your external_id must be unique: reusing one returns 409. See
External IDs.
POST
/
v2
/
projects
Create project
curl --request POST \
--url https://api.emidat.com/v2/projects \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "PRJ-2026-014",
"name": "Tower A",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 120
}
]
}
'import requests
url = "https://api.emidat.com/v2/projects"
payload = {
"external_id": "PRJ-2026-014",
"name": "Tower A",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 120
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'PRJ-2026-014',
name: 'Tower A',
customer_name: 'Bauherr GmbH',
address: {
country: 'DE',
city: 'Munich',
latitude: 48.1351,
longitude: 11.575,
street: 'Musterstraße',
house_number: '12',
postal_code: '80331',
state: 'Bavaria',
formatted_address: 'Musterstraße 12, 80331 Munich, Germany'
},
products: [{product_id: '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b', quantity: 120}]
})
};
fetch('https://api.emidat.com/v2/projects', 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://api.emidat.com/v2/projects",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'PRJ-2026-014',
'name' => 'Tower A',
'customer_name' => 'Bauherr GmbH',
'address' => [
'country' => 'DE',
'city' => 'Munich',
'latitude' => 48.1351,
'longitude' => 11.575,
'street' => 'Musterstraße',
'house_number' => '12',
'postal_code' => '80331',
'state' => 'Bavaria',
'formatted_address' => 'Musterstraße 12, 80331 Munich, Germany'
],
'products' => [
[
'product_id' => '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b',
'quantity' => 120
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emidat.com/v2/projects"
payload := strings.NewReader("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.emidat.com/v2/projects")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/projects")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 120\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}Authorizations
Per-manufacturer API key in the X-API-Key header, format
emidat-{key_id}-{secret} where key_id is a random public handle.
Issued by an owner in the Emidat
dashboard; carries its own permission scopes, optional plant
restrictions, and optional expiry. A revoked, expired, or unknown key
returns 401. See the Authentication guide for details.
Headers
Optional client-generated key of 1–255 characters (e.g. a UUID) that makes
a create idempotent — the only mechanism that does so. A replay carrying the same
key returns the original response unchanged (200); reusing a key with a
different request body (compared byte for byte) or create endpoint is
rejected with 409 err_idempotency_key_reused. Concurrent requests with
the same key receive 409 err_idempotency_in_progress. Keys are scoped
to your manufacturer; successful responses are retained for 6h without
extending that window on replay. Current permissions are required on
every retry; product-instance replays also require the original
production-data scopes. Deduplication is best effort: Redis data loss
can end the window early, and Redis unavailability, timeouts, or unreadable
cache entries can allow creation without replay protection. Successful
creates still return 201 if caching fails. Redis waits share a two-second
budget excluding creation time. Incompatible replay-format upgrades
reset replay protection, so retries across that boundary can create again.
An interrupted create can reserve the key for up to 6h.
See External IDs for recovery guidance.
Required string length:
1 - 255Body
application/json
Surrounding spaces are ignored; an empty name returns 422.
Minimum string length:
1Example:
"Tower A"
Name of one of your customers, exactly as it is in the Emidat app
(surrounding spaces are ignored). Customers are not created through
the API: a name with no customer returns 422
(err_customer_not_found).
Minimum string length:
1Example:
"Bauherr GmbH"
The site address of a project, stored exactly as sent; a field you
leave out is stored empty. A new or changed address needs city, and
is located to place the site: no location found in country returns
422 (err_address_not_found), and a lookup that cannot be carried
out right now returns 503 (err_geocoding_unavailable). An address
identical to the stored one (ignoring surrounding spaces) is kept as
it is, without a lookup.
Show child attributes
Show child attributes
Minimum array length:
1Show child attributes
Show child attributes
Your own code for this project. Optional. When provided it is unique
among your active projects — creating another with the same code
returns 409 (see External IDs).
Example:
"PRJ-2026-014"
Response
Returned unchanged — an Idempotency-Key replay.
UUID of the project.
Your own code for this project. null when none is set.
Example:
"Tower A"
The client a project is built for. Customers are managed in the Emidat
app; a project names its customer by customer_name.
Show child attributes
Show child attributes
The site address of a project, exactly as it was sent. Fields left
out are empty strings, except house_number, which is null.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
A1–A3 GWP-total (EN 15804+A2) of the whole delivery in kg CO₂e: the
sum over the lines of quantity times gwp_per_unit. null while
any line's gwp_per_unit is null; the lines show which.
As gwp_total, from the lines' gwp_per_unit_net. null while any
line's gwp_per_unit_net is null.
⌘I