curl -X POST "https://api.dcycle.io/v2/facilities" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Idempotency-Key: 5d1e2f3a-4b5c-4d6e-8f70-81a2b3c4d5e6" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"name": "Madrid Office", "country": "ES", "type": "rented", "categories": ["electricity", "heat"], "client_row_id": "SITE-001"},
      {"name": "Lyon Warehouse", "country": "FR", "type": "owned", "address": "12 Rue de la République, Lyon", "surface_area": 3200, "surface_area_unit": "m2"}
    ]
  }'

import os
import uuid

import requests

response = requests.post(
    "https://api.dcycle.io/v2/facilities",
    headers={
        "x-api-key": os.environ["DCYCLE_API_KEY"],
        "x-organization-id": os.environ["DCYCLE_ORG_ID"],
        "Idempotency-Key": str(uuid.uuid4()),  # keep it to retry this same batch
    },
    json={
        "records": [
            {"name": "Madrid Office", "country": "ES", "type": "rented", "client_row_id": "SITE-001"},
            {"name": "Lyon Warehouse", "country": "FR", "type": "owned"},
        ]
    },
    timeout=60,
)
response.raise_for_status()
for item in response.json()["items"]:
    print(item["client_row_id"], item["facility"]["id"])

const axios = require('axios');
const { randomUUID } = require('crypto');

const { data } = await axios.post(
  'https://api.dcycle.io/v2/facilities',
  {
    records: [
      { name: 'Madrid Office', country: 'ES', type: 'rented', client_row_id: 'SITE-001' },
      { name: 'Lyon Warehouse', country: 'FR', type: 'owned' },
    ],
  },
  {
    headers: {
      'x-api-key': process.env.DCYCLE_API_KEY,
      'x-organization-id': process.env.DCYCLE_ORG_ID,
      'Idempotency-Key': randomUUID(), // keep it to retry this same batch
    },
  },
);
data.items.forEach((item) => console.log(item.client_row_id, item.facility.id));

{
  "items": [
    {
      "source_row_index": 0,
      "client_row_id": "SITE-001",
      "facility": {
        "id": "0b8e4d2a-1c3f-4e5a-9b7d-6c8e0f2a4b6d",
        "organization_id": "a8315ef3-dd50-43f8-b7ce-d839e68d51fa",
        "name": "Madrid Office",
        "address": null,
        "country": "ES",
        "type": "rented",
        "categories": ["electricity", "heat"],
        "cups_list": null,
        "status": "active",
        "logistic_factor": 0.8,
        "surface_area": null,
        "surface_area_unit": null,
        "facility_purpose_type": "facilities",
        "created_at": "2026-10-07T09:12:44.381Z",
        "updated_at": "2026-10-07T09:12:44.381Z"
      }
    },
    {
      "source_row_index": 1,
      "client_row_id": null,
      "facility": {
        "id": "7f6e5d4c-3b2a-4190-8e7f-6d5c4b3a2918",
        "name": "Lyon Warehouse",
        "country": "FR",
        "type": "owned",
        "...": "..."
      }
    }
  ]
}

{
  "type": "https://code.dcycle.io/api-reference/errors#BULK_RECORDS_REJECTED",
  "title": "Unprocessable Content",
  "status": 422,
  "code": "BULK_RECORDS_REJECTED",
  "detail": "1 of the submitted records are invalid; nothing was written.",
  "errors": [
    {
      "source_row_index": 1,
      "client_row_id": null,
      "error_code": "REFERENCE_NOT_FOUND",
      "error_params": { "field": "country", "value": "UK" }
    }
  ],
  "rejected": 1,
  "request_id": "b2248a31-0f1b-4a7d-83ce-b29bd5977b4c"
}

{ "dry_run": true, "submitted": 2, "valid": 2 }