Skip to main content
POST
Retrieve a page of rows from a report run.

Authorizations

Authorization
string
header
required

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

Body

The body containing the required opaque report-run ReportId, grid query, optional Prefilter, and optional result-version TimePositionsLoaded timestamp. Report restriction, report type, portfolio type, market-data environment, and caller fields are server-managed. Valid column names, filter operators, time-series semantics, and row-value units are not defined by this operation.

Report-run, grid, restriction, and filter selectors for retrieving result rows.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.ReportQuery.ApiGetAgGridRowsRequest, Derivitec.Web.Core
time_positions_loaded
string<date-time>

Timestamp identifying the loaded-position result version to query.

report_id
string | null

Opaque identifier of the report run to retrieve or query. The value must not be null or empty.

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
grid_query
object

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

report_type
enum<string>

Report category that selects the applicable result or metadata shape.

Available options:
risk,
var,
pnl,
time_series
market_data_environment_name_mappings
object | null

Market-data environment name mapping exposed by this request; accepted keys, values, and behavior are not established.

prefilter
object

Base selection criterion for a named report-data field.

Response

Returns the requested rows, the result-version timestamp, and the LastRow paging indicator, or an unsuccessful envelope when the run is unavailable or restricted.

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.