Docs

List insights

GET /api/v1/programmatic/insights

GET/api/v1/programmatic/insights
Insightsv1insights:read

Returns generated insights for the required YYYY-MM period.

Parameters

NameInType Description
account_idsqueryarray<string>Optional <account_ids>
periodquerystringRequired 2026-07

Code examples

curl --request GET \
  --url 'https://api.tetri.app/api/v1/programmatic/insights?account_ids=<account_ids>&period=2026-07' \
  --header 'Authorization: Bearer $TETRI_API_TOKEN'

Responses

200Insights returned successfully.
401The access token is missing, invalid, expired, or revoked.
403The token does not have the required scope or workspace access.
429The credential has exceeded its request limit.