POST

/Report

Usage Notes

When

Initiate report generation
Submit report parameters for processing

Requirements

ReportName required (identifies report type)
Parameters dictionary with report-specific options

Notes

Stage 1 of 3-stage workflow
All parameter values must be strings
Returns reference GUID for tracking

Description

Submits a report generation request. Returns reference GUID for status polling and retrieval.

Required Headers - See Authentication

Header	Value	Description
Content-Type	application/json	Request content type
Authorization	{accessToken}	Bearer token for API access
Version	2.0	API version identifier

Request Body

Parameter	Type	Required	Description
`reportName` >	string	> Required...	The name of the report to generate. Examples include EntityBalanceReport, TransactionSummary, DistributionReconciliation, and other business intelligence reports.
`parameters`	object	Optional	Dynamic collection of report-specific key-value parameters. All values must be strings. Available parameters vary by report type for filtering, grouping, and output control.

reportName

string

> Required...

The name of the report to generate. Examples include EntityBalanceReport, TransactionSummary, DistributionReconciliation, and other business intelligence reports.

parameters

object

Optional

Dynamic collection of report-specific key-value parameters. All values must be strings. Available parameters vary by report type for filtering, grouping, and output control.

Example Requests

bash

# Entity Balance Report
curl -X POST 'https://api.7g.com.au/Report' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "reportName": "EntityBalanceReport",
    "parameters": {
      "ProductID": "123",
      "FromDate": "2024-01-01",
      "ToDate": "2024-12-31",
      "IncludeClosingBalances": "true"
    }
  }'

# Transaction Summary Report
curl -X POST 'https://api.7g.com.au/Report' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "reportName": "TransactionSummary",
    "parameters": {
      "BizEntityID": "456",
      "BizTransactionTypeID": "1",
      "Status": "Complete",
      "FromDate": "2024-01-01",
      "ToDate": "2024-03-31",
      "PageSize": "500"
    }
  }'

Response Examples

json

{
  "result": true,
  "message": "Your report request has been queued for background processing. Use the Status endpoint with the provided reference value to track its progress.",
  "data": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}