API Reference

Monthly Insights Totals API

post
https://api.connect.earth/monthly-insights/totals

Call this endpoint to get the aggregated data of a user's emissions for a specific month or a range of months.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Include here the userId and startMonth/endMonth or months for the insights. Add fixedEquivalents optionally to get the fixed equivalents of the emissions per month.

required

Unique ID of the user. This parameter can be a single userId or an array of userIds

string
Defaults to 2022-01

Start month of the period you want to be returned in the response.

string
Defaults to 2022-03

End month of the period you want to be returned in the response.

months
array of strings

List of months you want to be returned in the response in YYYY-MM format, with a maximum of 12 months.

months
fixedEquivalents
array of strings

List of equivalent types you want to be returned in the response to compare your emissions against. Options are comparing against mileage in a car and amount of CO2 absorbed by number of trees.

fixedEquivalents
boolean

Indicates whether the user wants equivalents to be included in the response to compare their emissions with real-world cases.

boolean

Returns the total emissions by month if set to false or return the aggregate of all the months in the period if set to true.

categoryFilter
array of strings

Filter the monthly totals by category.

categoryFilter
Headers
string
required
Responses

Updated over 1 year ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 1 year ago