Skip to main content
POST
Retrieve a page from the latest eligible named report.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

The body containing required accessible ReportName and PortfolioName; GridQuery with rows defaulting from StartRow=0 through EndRow=50 plus optional grouping, group keys, filters, sorting, and IsTimeSeriesRequest; optional PortfolioType, reporting currency, market-data environment names, and PnlLookback; and LiveScheduledReport, which defaults to false.

Selectors for retrieving the latest available report-grid rows by report name.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.ReportQuery.ApiGetLatestAgGridRowsRequest, Derivitec.Web.Core
report_name
string | null

Organisation-scoped name of the report definition to use. The value must not be null or empty.

Example:

"Daily risk overview"

reporting_currency
string | null

Currency in which report values are expressed. When null, the service uses the caller's configured reporting currency or USD.

Example:

"USD"

market_data_environment_names
string[] | null

Names of market-data environments to use for the report. The list is empty by default.

portfolio_name
string | null

Name of the portfolio to select. The value must not be null or empty.

Example:

"Example portfolio"

portfolio_type
enum<string> | null

Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously.

Available options:
derivitec,
enfusion,
orchestrade,
liquidity_book,
maia,
fund_studio,
not_set
pnl_lookback
enum<string> | null

Optional predefined P&L lookback selection.

Available options:
daily,
month_to_date,
quarter_to_date,
year_to_date,
annual
grid_query
object

Client grid query for selecting, grouping, filtering, and sorting report rows.

live_scheduled_report
boolean

Whether the latest-row request addresses the exposed live scheduled-report mode.

Response

Returns the selected report rows, LastRow, and segment-loaded time, or an unsuccessful envelope when no eligible report or required row restriction is available.

Paged report-result rows, their result-version timestamp, and final-row indicator.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.ReportQuery.ApiGetAgGridRowsResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.

last_row
integer<int32>

Total row count when established, or -1 when the final count is not yet known.

data
any[] | null

Report-grid rows returned for the requested page.

segment_loaded_time
string<date-time>

Timestamp identifying the returned result segment.