Skip to main content
POST
Submit a P&L 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 an accessible ReportName and PortfolioName; optional PortfolioType; optional ReportingCurrency, which defaults to the caller preference and then USD; optional accessible MarketDataEnvironmentNames; calendar-date FinalDate and optional InitialDate; optional LookbackPeriod (Daily, MonthToDate, QuarterToDate, YearToDate, or Annual); and RunDateIsToday. Report-definition, restriction, provider, portfolio identifier, and caller fields are server-managed. Other inherited run fields have no action-level effect established here.

Date-period and lookback selections for submitting a P&L report run.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Reports.ApiPnlReportJobRequest, Derivitec.Web.Core
id
string<uuid>

Opaque submission identifier; it is distinct from the companion ReportId.

report_id
string<uuid>

Opaque identifier reserved for the report run produced by this submission; it is distinct from the client request identifier.

run_date
string<date-time>

Requested or recorded report-run date; where RunDateIsToday is present and true, that companion flag takes precedence.

pricing_date
string<date-time> | null

Date used to price positions for the report; no time-zone convention is established by this contract.

market_date
string<date-time> | null

Market-data date used or recorded for the report run.

portfolio_date_time
string<date-time> | null

Portfolio snapshot date and time used or recorded for the report; no time-zone convention is established here.

market_data_override
object

Optional market-data substitutions supplied with pricing, risk, or report calculations.

real_time_mkt_data
boolean

Whether the report run uses the exposed real-time market-data selection.

run_date_is_today
boolean

Whether the current day is selected instead of the supplied run date.

report_run_type
enum<string>

How the report run was initiated: on demand, scheduled, or live.

Available options:
on_demand,
scheduled,
live
position_filter_name
string | null

Name of the saved position filter.

position_filter
object

Base selection criterion for a named report-data field.

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
initial_date
string<date-time> | null

Optional initial date of the P&L report period.

final_date
string<date-time>

Final date of the P&L report period.

lookback_period
enum<string> | null

Optional predefined P&L lookback selection.

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

Response

Returns the submitted report-run identifier, or an unsuccessful envelope for an unavailable selector, invalid lookback value, or rejected submission; no report data or completion state is included.

Response envelope for a P&L report-run submission.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Reports.ApiPnlReportJobResponse, 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.

report_id
string<uuid>

Opaque report-run identifier assigned when submission succeeds; otherwise the empty GUID.