SaaSFlow
DevelopersAPIReferencereports

Retrieve version

Retrieve one superseded report version with its full document, for reading what an earlier run of the same report actually said.

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/reports/{id}/versions/{versionId}

Authorization

headerAuthorization<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.

Path Parameters

companyId*string
Length1 <= length
id*string
Length1 <= length
versionId*string
Length1 <= length

Response Body

A superseded report version, including its document.

application/json
  1. response
id*string
Formatuuid
companyId*string
Formatuuid
reportId*string

The report this superseded version belongs to.

Formatuuid
supersededBy*string

What replaced this version, e.g. chat.

document*

The superseded report document.

createdTime*string
Formatdate-time
curl -X GET 'https://api.saasflow.com/companies/string/reports/string/versions/string'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",  "reportId": "836df459-dc40-4aa1-972a-6eb0a864dff9",  "supersededBy": "string",  "document": {    "schemaVersion": 1,    "title": "string",    "period": {      "month": "string"    },    "facts": {      "mrrBasis": "cmrr",      "timeZone": "string",      "endMrr": 0,      "priorEndMrr": 0,      "mrrGrowthPct": 0,      "endCustomerCount": 0,      "newMrr": 0,      "churnedMrr": 0    },    "summary": "string",    "html": "string"  },  "createdTime": "2019-08-24T14:15:22Z"}

List versions

List the superseded versions of a report, oldest first. Regenerating a report keeps what it replaced, so this is the audit trail of how the numbers and…

Apply

Apply a reviewed batch of categorization suggestions in one call. Counterparties that do not exist yet go in vendorsToCreate and customersToCreate with a…