API Documentation
  • API Documentation
  • Ecosuite Project Data API
    • Authentication
    • OpenAPI reference
      • Events
        • Resolve
      • Feedback
      • Profile
      • Portfolios
      • Projects
        • Contacts
        • Pro forma
          • Versions
        • I2x
        • Records
        • Sites
          • Records
          • Systems
            • Records
        • Record documents
      • Record documents
      • Records
        • Record documents
      • Service requests
        • Generate
        • Resolve
      • Tariff
      • User groups
      • Users
        • Alerts
        • Groups
          • Reset
        • Mfa
        • Notifications
        • Resend
      • User types
      • Audit
        • Assets
        • Projects
        • Users
      • Coda
        • Milestones
        • Import
      • Connectivity
        • Data
        • Devices
      • Dashboard
        • Status
      • Energy
        • Datums
          • Most recent
          • Projects
          • Consumption
            • Cost
              • Projects
            • Predicted
              • Projects
            • Projects
          • Cumulative
            • Projects
          • Generation
            • Expected
            • Predicted
              • Projects
          • Nodes
            • Projects
        • Export
        • Instantaneous
        • Readings
        • Status
      • Finance
        • Cashflow totals
        • Report
        • Transactions
        • Sources uses
          • Sources uses
        • Export
          • Report
        • Projects
          • Billing
          • CashFlowTimeSeriesArrears
          • Categories
          • Irr categories
          • Report
          • Settings
          • Sources uses
          • Import
          • Cash flows
            • Payment logs
          • Pro forma
            • Irr
        • Record
          • Payments
        • Softledger
          • Locations
      • Media
        • Files
        • Tags
          • Storage
            • Code
            • Labels
          • Default
        • Storage
          • File
          • Code
      • Public
        • Projects
        • Energy
          • Datums
            • Projects
          • Readings
            • Projects
      • Schemas
        • Rfi
        • RfiReply
        • Dr event
        • Dr notification
        • Event
        • Participant
        • Finance
        • Notification
        • Portfolio
        • Pro forma
        • Profile
        • Project
        • Record
        • Service request
        • Site
        • System
        • User
        • User type
        • User groups
        • New tariff
        • Tariff
      • Rfi
        • Thread
          • Code
          • Resolve
          • Version
          • Replies
        • Reply
          • Version
      • Search
        • Refinements
      • Solarnetwork
        • Devices
        • Instruction
        • Nodes
        • Ssh
        • Credentials
          • Solarflux
          • Solarnode
          • Ssh
        • Metadata
          • Projects
        • Settings
          • Node ids
        • Solarnode
          • Login url
      • Tools
        • Address business details
      • Dr
        • Participants
        • Dr events
        • Dr notifications
      • Report
        • Operating
          • Project
      • Weather
        • Datums
          • Projects
        • Daylight
          • Projects
            • Sites
        • Projects
          • Sites
    • OpenAPI Specification
  • Ecosuite Time Series Data API
Powered by GitBook
On this page
  1. Ecosuite Project Data API
  2. OpenAPI reference
  3. Projects

Sites

PreviousRecordsNextRecords

Deletes an existing site

delete

Deletes an existing site

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

Responses
200
successful operation
application/json
Responseobject
400
Invalid status value
application/json
delete
DELETE //projects/{projectId}/sites/{siteId} HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Accept: */*
{}
  • POSTCreate a new site
  • PUTUpdate an existing site
  • DELETEDeletes an existing site

Create a new site

post

Create a new site with the specified ID

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

Body

Refer to the /schemas/site endpoint for the full JSON Schema definition

codestringRequiredPattern: ^[A-Z0-9]*$
namestringRequired
productionStartDatestring · dateOptional
generationStartDatestring · dateOptional
consumptionStartDatestring · dateOptional
storageStartDatestring · dateOptional
addressstringRequired
townstringRequired
statestringRequired
latnumber · min: -180 · max: 180Required
longnumber · min: -180 · max: 180Required
serviceIdstringOptional
parcelIDstringOptional
parcelAcreagestringOptional
zoningDistrictstringOptional
ownerOfRecordstringOptional
locationIdintegerOptional

The ID of a SolarNetwork location; used to retrieve weather details

plantIdstringOptional
utilitystringOptional
emissionsApproximationMethodstring · enumOptionalPossible values:
timezonestringOptional
expectedDailyDatanumberOptional
accessNotesstringOptional
Responses
200
successful operation
application/json
400
Invalid status value
application/json
post
POST //projects/{projectId}/sites/{siteId} HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 653

{
  "code": "text",
  "name": "text",
  "productionStartDate": "2025-06-16",
  "generationStartDate": "2025-06-16",
  "consumptionStartDate": "2025-06-16",
  "storageStartDate": "2025-06-16",
  "address": "text",
  "town": "text",
  "state": "text",
  "lat": 1,
  "long": 1,
  "serviceId": "text",
  "parcelID": "text",
  "parcelAcreage": "text",
  "zoningDistrict": "text",
  "ownerOfRecord": "text",
  "locationId": 1,
  "plantId": "text",
  "utility": "text",
  "emissionsApproximationMethod": "static",
  "timezone": "text",
  "expectedDailyData": 1,
  "links": [
    {
      "name": "text",
      "url": "https://example.com"
    }
  ],
  "accessNotes": "text",
  "contacts": [
    {
      "name": "text",
      "type": "text",
      "email": "name@gmail.com",
      "phone": "text",
      "voip": "text",
      "notes": "text"
    }
  ]
}
{
  "site": {
    "code": "text",
    "name": "text",
    "productionStartDate": "2025-06-16",
    "generationStartDate": "2025-06-16",
    "consumptionStartDate": "2025-06-16",
    "storageStartDate": "2025-06-16",
    "address": "text",
    "town": "text",
    "state": "text",
    "lat": 1,
    "long": 1,
    "serviceId": "text",
    "parcelID": "text",
    "parcelAcreage": "text",
    "zoningDistrict": "text",
    "ownerOfRecord": "text",
    "locationId": 1,
    "plantId": "text",
    "utility": "text",
    "emissionsApproximationMethod": "static",
    "timezone": "text",
    "expectedDailyData": 1,
    "links": [
      {
        "name": "text",
        "url": "https://example.com"
      }
    ],
    "accessNotes": "text",
    "contacts": [
      {
        "name": "text",
        "type": "text",
        "email": "name@gmail.com",
        "phone": "text",
        "voip": "text",
        "notes": "text"
      }
    ]
  }
}

Update an existing site

put

Update an existing site

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

Body

Refer to the /schemas/site endpoint for the full JSON Schema definition

codestringRequiredPattern: ^[A-Z0-9]*$
namestringRequired
productionStartDatestring · dateOptional
generationStartDatestring · dateOptional
consumptionStartDatestring · dateOptional
storageStartDatestring · dateOptional
addressstringRequired
townstringRequired
statestringRequired
latnumber · min: -180 · max: 180Required
longnumber · min: -180 · max: 180Required
serviceIdstringOptional
parcelIDstringOptional
parcelAcreagestringOptional
zoningDistrictstringOptional
ownerOfRecordstringOptional
locationIdintegerOptional

The ID of a SolarNetwork location; used to retrieve weather details

plantIdstringOptional
utilitystringOptional
emissionsApproximationMethodstring · enumOptionalPossible values:
timezonestringOptional
expectedDailyDatanumberOptional
accessNotesstringOptional
Responses
200
successful operation
application/json
400
Invalid status value
application/json
put
PUT //projects/{projectId}/sites/{siteId} HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 653

{
  "code": "text",
  "name": "text",
  "productionStartDate": "2025-06-16",
  "generationStartDate": "2025-06-16",
  "consumptionStartDate": "2025-06-16",
  "storageStartDate": "2025-06-16",
  "address": "text",
  "town": "text",
  "state": "text",
  "lat": 1,
  "long": 1,
  "serviceId": "text",
  "parcelID": "text",
  "parcelAcreage": "text",
  "zoningDistrict": "text",
  "ownerOfRecord": "text",
  "locationId": 1,
  "plantId": "text",
  "utility": "text",
  "emissionsApproximationMethod": "static",
  "timezone": "text",
  "expectedDailyData": 1,
  "links": [
    {
      "name": "text",
      "url": "https://example.com"
    }
  ],
  "accessNotes": "text",
  "contacts": [
    {
      "name": "text",
      "type": "text",
      "email": "name@gmail.com",
      "phone": "text",
      "voip": "text",
      "notes": "text"
    }
  ]
}
{
  "site": {
    "code": "text",
    "name": "text",
    "productionStartDate": "2025-06-16",
    "generationStartDate": "2025-06-16",
    "consumptionStartDate": "2025-06-16",
    "storageStartDate": "2025-06-16",
    "address": "text",
    "town": "text",
    "state": "text",
    "lat": 1,
    "long": 1,
    "serviceId": "text",
    "parcelID": "text",
    "parcelAcreage": "text",
    "zoningDistrict": "text",
    "ownerOfRecord": "text",
    "locationId": 1,
    "plantId": "text",
    "utility": "text",
    "emissionsApproximationMethod": "static",
    "timezone": "text",
    "expectedDailyData": 1,
    "links": [
      {
        "name": "text",
        "url": "https://example.com"
      }
    ],
    "accessNotes": "text",
    "contacts": [
      {
        "name": "text",
        "type": "text",
        "email": "name@gmail.com",
        "phone": "text",
        "voip": "text",
        "notes": "text"
      }
    ]
  }
}