Skip to main content
POST
/
organizations
/
{orgId}
/
dataexplorer
/
commitments
/
download
/
json
Download Commitments data as JSON.
curl --request POST \
  --url https://api.m3ter.com/organizations/{orgId}/dataexplorer/commitments/download/json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "startDate": "2023-11-07T05:31:56Z",
  "endDate": "2023-11-07T05:31:56Z",
  "dimensions": [
    {
      "name": "<string>",
      "filter": [
        "<string>"
      ],
      "attributes": [
        "<string>"
      ]
    }
  ],
  "limit": 1000
}
'
{
  "downloadUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

m3ter supports machine to machine authentication using the clientCredentials OAuth2 flow.

The authorizationCode flow controls access for human users via the m3ter Console application.

Path Parameters

​
orgId
string
required

UUID of the organization

Body

application/json

Data Explorer commitments query.

​
startDate
string<date-time>
required

ISO 8601 formatted start date for the commitment.

​
endDate
string<date-time>
required

ISO 8601 formatted end date for the commitment.

​
dimensions
object[]

Dimensions to filter by. The only valid dimension is 'account'.

Maximum array length: 100
​
limit
integer<int32>

Limit the number of data points returned

Required range: 1 <= x <= 2000

Response

Contains a link to download the file.

Download link for Data Explorer data

​
downloadUrl
string<url>