SaaSFlow
DevelopersAPIReferencedata

PeriodDetails

Use this when the user asks for the detailed breakdown of a single period (transactions, categorizations, totals). Requires permissions: transactions:read.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
POST
/companies/{companyId}/data/periodDetails

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/companies/string/data/periodDetails" \  -H "Content-Type: application/json" \  -d '{    "startDate": "string",    "endDate": "string",    "dateDefinition": "distributed",    "splitBy": "account"  }'
{  "amountBySplitId": {    "property1": 0,    "property2": 0  },  "total": 0,  "namesBySplitId": {    "property1": "string",    "property2": "string"  },  "invoicedAmountBySplitId": {    "property1": 0,    "property2": 0  },  "invoicedTotal": 0,  "invoicedDueDateRange": {    "min": "string",    "max": "string"  }}

ProfitLossData

Use this when the user asks for a P&L statement (revenue, costs, gross/operating/net profit) for a period. Requires permissions: financials:read.

Cohorts

Use this when the user asks about customer retention or revenue retention by cohort. Requires permissions: subscriptions:read, customers:read.