Investment Details

Request investment details

post

Headers

Preferstringrequired

Must be set to respond-async to indicate the client requires that
the request is processed asynchronously. If omitted or set to another value, the server responds with an error message.

Allowed values:respond-async

Body

application/json

RequestInvestmentDetails

Request investment details for up to 3 views and 250 investments.

* Additional properties are NOT allowed.
investmentsarray[object]required

Investment to query. Investment look up is supported.

>= 1 items<= 250 items

* Additional properties are NOT allowed.
Show Child Parameters
viewsarray[object]required

List of views.

>= 1 items<= 3 items

Show Child Parameters
startDatestring(date)

Specifies the start date of a time series. Accepts yyyy-MM-dd.

Example:2020-01-25

endDatestring(date)

Specifies the start date of a time series. Accepts yyyy-MM-dd.

Example:2024-01-25

languageIdstring

Specifies the language to filter results on. Required for language-dependent data.

Allowed values:ENGSPAFRADEUITAJPNCHIZHOKOR

Default:ENG

countryIdstring

Specifies the country to filter results on. Accepts 3-character ISO 3166-1 country codes. Required for country-dependent data.

Default:USA

Example:CAN

regionIdstring

Specifies the region for style box breakpoints.

Allowed values:1234567

Example:1

Response

application/json

Accepted

ResponseAccepted

Defines the HTTP 202 Accepted response returned when a request is
accepted for asynchronous processing. Includes the job identifier,
metadata, and links to retrieve the job status or results.

jobIdstring

A unique identifier for the asynchronous job. This ID is used to
track processing progress or retrieve completed results.

Example:16bf1a7a-c883-4424-8810-2f4e9d244d40

_linksobject

A set of hypermedia links providing URLs for polling job status or
accessing results when available.

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject
* Additional properties are NOT allowed.
Show Child Parameters
post/direct-web-services/v1/investments

Body

{ "investments": [ { "id": "id" } ], "views": [ { "viewId": "viewId" } ] }
 
application/json

Retrieve investment details

Retrieve asynchronous request results.

get

Path Parameters

resultIdstringrequired

Response

application/json

OK

ResponseGetResults

Response get results.

investmentsarray

All fields are nullable. Empty or null value fields are not returned.

Show Child Parameters
metadataobject
* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/v1/investments/result/{resultId}
 
application/json

Utility Endpoints

List views

Retrieve the list of data views your account is entitled to access,
along with the corresponding viewId values required to request
investment details.

get

Response

application/json

OK

ResponseListViews

Response containing entitled view packages and their associated dataset viewIds.

* Additional properties are NOT allowed.
viewsarray[object]required

A view package and the dataset viewIds it contains.

* Additional properties are NOT allowed.
Show Child Parameters
metadataobjectrequired
* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/v1/investments/views
 
application/json