Skip to main content
POST
Store projected dividends for equities.

Authorizations

Authorization
string
header
required

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

Body

The upload payload. Provide either ProviderId or MarketDataEnvironmentName, not both; omitting both selects the caller's organisation scope. Dividends must be non-empty; each row supplies an equity identifier, reference and event dates, cash, yield, rate, tax, currency, confirmation, dividend type, and optional index-component identifier.

Submits projected dividend schedules.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.MarketData.ApiUploadProjectedDividendsRequest, Derivitec.Web.Core
market_data_environment_name
string | null

Name of the market-data environment to use. Supply either this name or provider_id, not both.

Example:

"Example market data"

provider_id
string | null

Opaque identifier of the market-data provider to use. Supply either this identifier or market_data_environment_name, not both.

use_best_effort
boolean

Requests independent handling of input records when one cannot be processed; defaults to false.

dividends
object[] | null

Projected dividend schedules to upload.

Response

Returns whether the projected dividends were stored and validation or unsupported-identifier errors.

Returns the success flag and error messages from a projected-dividend upload.

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