Reports

searches all reports

get

List all reports known to the server. May filter results by programID, eventID, and clientName as query param. Use skip and pagination query params to limit response size.

Authorizations

Query parameters

programIDstring · min: 1 · max: 128Optional

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

eventIDstring · min: 1 · max: 128Optional

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

clientNamestringOptional

filter results to reports with clientName.

Example: 999

skipinteger · int32Optional

number of records to skip for pagination.

limitinteger · int32 · max: 50Optional

maximum number of records to return.

x-startstring · date-timeOptional

start of timeperiod for which to return reports (extension - not part of the OpenADR specification)

x-endstring · date-timeOptional

end of timeperiod for which to return reports (extension - not part of the OpenADR specification)

Responses

get

HTTPcURLJavaScriptPython

GET /api/openadr/v1/reports HTTP/1.1
Host: vtn3.switchmarket.se
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": "object-999",
    "createdDateTime": "2023-06-15T09:30:00Z",
    "modificationDateTime": "2023-06-15T09:30:00Z",
    "objectType": "REPORT",
    "programID": "object-999",
    "eventID": "object-999",
    "clientName": "VEN-999",
    "reportName": "Battery_usage_04112023",
    "payloadDescriptors": [
      {
        "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
        "payloadType": "USAGE",
        "readingType": "DIRECT_READ",
        "units": "KWH",
        "accuracy": 0,
        "confidence": 100
      }
    ],
    "resources": [
      {
        "resourceName": "RESOURCE-999",
        "intervalPeriod": {
          "start": "2023-06-15T09:30:00Z",
          "duration": "PT1H",
          "randomizeStart": "PT1H"
        },
        "intervals": [
          {
            "id": 0,
            "intervalPeriod": {
              "start": "2023-06-15T09:30:00Z",
              "duration": "PT1H",
              "randomizeStart": "PT1H"
            },
            "payloads": [
              {
                "type": "PRICE",
                "values": [
                  0.17
                ]
              }
            ]
          }
        ]
      }
    ]
  }
]

add a report

post

Create a new report in the server.

Authorizations

Body

report object.

idstring · min: 1 · max: 128Optional

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

createdDateTimestring · date-timeOptional

datetime in ISO 8601 format

Example: 2023-06-15T09:30:00Z

modificationDateTimestring · date-timeOptional

datetime in ISO 8601 format

Example: 2023-06-15T09:30:00Z

objectTypestring · enumOptional

Used as discriminator

Possible values:

programIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

eventIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

clientNamestring · min: 1 · max: 128Required

User generated identifier; may be VEN ID provisioned out-of-band.

Example: VEN-999

reportNamestring | nullableOptional

User defined string for use in debugging or User Interface.

Default: nullExample: Battery_usage_04112023

Responses

post

HTTPcURLJavaScriptPython

POST /api/openadr/v1/reports HTTP/1.1
Host: vtn3.switchmarket.se
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 696

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}

searches reports by reportID

get

Fetch the report specified by the reportID in path.

Authorizations

Path parameters

reportIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

Responses

get

HTTPcURLJavaScriptPython

GET /api/openadr/v1/reports/{reportID} HTTP/1.1
Host: vtn3.switchmarket.se
Authorization: Bearer JWT
Accept: */*

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}

update a report

put

Update the report specified by the reportID in path.

Authorizations

Path parameters

reportIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

Body

report object.

idstring · min: 1 · max: 128Optional

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

createdDateTimestring · date-timeOptional

datetime in ISO 8601 format

Example: 2023-06-15T09:30:00Z

modificationDateTimestring · date-timeOptional

datetime in ISO 8601 format

Example: 2023-06-15T09:30:00Z

objectTypestring · enumOptional

Used as discriminator

Possible values:

programIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

eventIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

clientNamestring · min: 1 · max: 128Required

User generated identifier; may be VEN ID provisioned out-of-band.

Example: VEN-999

reportNamestring | nullableOptional

User defined string for use in debugging or User Interface.

Default: nullExample: Battery_usage_04112023

Responses

put

HTTPcURLJavaScriptPython

PUT /api/openadr/v1/reports/{reportID} HTTP/1.1
Host: vtn3.switchmarket.se
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 696

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}

delete a report

delete

Delete the report specified by the reportID in path.

Authorizations

Path parameters

reportIDstring · min: 1 · max: 128Required

URL safe VTN assigned object ID.

Example: object-999Pattern: ^[a-zA-Z0-9_-]*$

Responses

delete

HTTPcURLJavaScriptPython

DELETE /api/openadr/v1/reports/{reportID} HTTP/1.1
Host: vtn3.switchmarket.se
Authorization: Bearer JWT
Accept: */*

{
  "id": "object-999",
  "createdDateTime": "2023-06-15T09:30:00Z",
  "modificationDateTime": "2023-06-15T09:30:00Z",
  "objectType": "REPORT",
  "programID": "object-999",
  "eventID": "object-999",
  "clientName": "VEN-999",
  "reportName": "Battery_usage_04112023",
  "payloadDescriptors": [
    {
      "objectType": "REPORT_PAYLOAD_DESCRIPTOR",
      "payloadType": "USAGE",
      "readingType": "DIRECT_READ",
      "units": "KWH",
      "accuracy": 0,
      "confidence": 100
    }
  ],
  "resources": [
    {
      "resourceName": "RESOURCE-999",
      "intervalPeriod": {
        "start": "2023-06-15T09:30:00Z",
        "duration": "PT1H",
        "randomizeStart": "PT1H"
      },
      "intervals": [
        {
          "id": 0,
          "intervalPeriod": {
            "start": "2023-06-15T09:30:00Z",
            "duration": "PT1H",
            "randomizeStart": "PT1H"
          },
          "payloads": [
            {
              "type": "PRICE",
              "values": [
                0.17
              ]
            }
          ]
        }
      ]
    }
  ]
}