TermsAndConditionsExtractionRequest

I receive empty file results for the following rest api in Java:

@{"ExtractionRequest":{"@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.TermsAndConditionsExtractionRequest",
"ContentFieldNames":["Ticker","Coupon
Type","Day Count Code","Coupon Rate"],
"IdentifierList":{
"@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.EntityIdentifierList",
"EntityIdentifiers":[
{"Identifier":"18236","IdentifierType":"OrgId"}
]},
"Condition":{
"ExcludeWarrants":true,"FixedIncomeRatingSources":
"Fitch",
"StartDate":"2017-01-02T00:00:00.000Z",
"UseRelativeAnalytics":true
}
} }

What is the proper way to call TermsAndConditionsExtractionRequest?

Thanks

Find more posts tagged with

dss

dss-rest-api

datascope-select

terms-and-conditions

Accepted answers

veerapath.rungruengrayubkul

You can use the ExtractWithNotes endpoint instead of Extract to get more information from the Note. The following error message is in the Note.

45 Instruments suppressed due to rating date not on or after 01/02/2017.

It could be related to the Delta Extraction that contains only data for instruments that have had a ratings change since the last extraction execution.

Once the "FixedIncomeRatingSources" and "StartDate" conditions are removed from the request, data can be extracted properly. Below is the modified request.

{"ExtractionRequest":

@{"@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.TermsAndConditionsExtractionRequest", 

"ContentFieldNames":["Ticker","Coupon Type","Day Count Code","Coupon Rate"], 

"IdentifierList":{ "@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.EntityIdentifierList", "EntityIdentifiers":[ {"Identifier":"18236","IdentifierType":"OrgId"} ]}, 

"Condition":{ "ExcludeWarrants":true,"UseRelativeAnalytics":true } } }

Below is the information in the DSS User Guide document.

All comments

chavalit-jintamalit

Hi @Axegine,

You can download the POSTMAN sample collections from here.

From tutorial 7b Request Terms and Conditions example.

This is the sample request:

POST https://hosted.datascopeapi.reuters.com/RestApi/v1/Extractions/Extract HTTP/1.1
Prefer: respond-async
Content-Type: application/json
Authorization: Token <your token>
cache-control: no-cache
Postman-Token: 37111503-5017-4a44-adb7-b97253d8207c
User-Agent: PostmanRuntime/7.1.1
Accept: */*
Host: hosted.datascopeapi.reuters.com
cookie: DSSAPI-COOKIE=R3148268809
accept-encoding: gzip, deflate
content-length: 1013
Connection: close

{
    "ExtractionRequest": {
        "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.TermsAndConditionsExtractionRequest",
        "ContentFieldNames": [
           "RIC", "CUSIP", "ISIN", "SEDOL", "Issuer OrgID", "Currency Code"
        ],
        "IdentifierList": {
            "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.InstrumentIdentifierList",
            "InstrumentIdentifiers": [
                {
                    "Identifier": "00209tab1",
                    "IdentifierType": "Cusip"
                },
                {
                    "Identifier": "IBM.N",
                    "IdentifierType": "Ric"
                },
                {
                    "Identifier": "US4592001014",
                    "IdentifierType": "Isin"
                },
                {
                    "Identifier": "B1YW440",
                    "IdentifierType": "Sedol"
                }
            ]
        }
    }
}

This is the sample response:

HTTP/1.1 200 OK
Set-Cookie: DSSAPI-COOKIE=R3148268809; path=/
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/7.5
X-Request-Execution-Correlation-Id: 7e4613d8-71e0-45ea-975f-bbe460f201c2
X-App-Id: Custom.RestApi
X-App-Version: 11.3.534.64
Date: Tue, 09 Jan 2018 02:56:55 GMT
Connection: close
Content-Length: 861

@{"@odata.context":"https://hosted.datascopeapi.reuters.com/RestApi/v1/$metadata#Collection(ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.ExtractionRow)","value":[{"IdentifierType":"Cusip","Identifier":"00209TAB1","RIC":"00209TAB1=RRPS","CUSIP":"00209TAB1","ISIN":"US00209TAB17","SEDOL":"2166502","Issuer OrgID":"172642","Currency Code":"USD"},{"IdentifierType":"Ric","Identifier":"IBM.N","RIC":"IBM.N","CUSIP":"459200101","ISIN":"US4592001014","SEDOL":"2005973","Issuer OrgID":"18228","Currency Code":"USD"},{"IdentifierType":"Isin","Identifier":"US4592001014","RIC":"IBM.N","CUSIP":"459200101","ISIN":"US4592001014","SEDOL":"2005973","Issuer OrgID":"18228","Currency Code":"USD"},{"IdentifierType":"Sedol","Identifier":"B1YW440","RIC":"LP71000002","CUSIP":null,"ISIN":"GB00B1YW4409","SEDOL":"B1YW440","Issuer OrgID":"100691344","Currency Code":"GBp"}]}

veerapath.rungruengrayubkul

You can use the ExtractWithNotes endpoint instead of Extract to get more information from the Note. The following error message is in the Note.

45 Instruments suppressed due to rating date not on or after 01/02/2017.

It could be related to the Delta Extraction that contains only data for instruments that have had a ratings change since the last extraction execution.

Once the "FixedIncomeRatingSources" and "StartDate" conditions are removed from the request, data can be extracted properly. Below is the modified request.

{"ExtractionRequest":

@{"@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.TermsAndConditionsExtractionRequest", 

"ContentFieldNames":["Ticker","Coupon Type","Day Count Code","Coupon Rate"], 

"IdentifierList":{ "@odata.type":"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.EntityIdentifierList", "EntityIdentifiers":[ {"Identifier":"18236","IdentifierType":"OrgId"} ]}, 

"Condition":{ "ExcludeWarrants":true,"UseRelativeAnalytics":true } } }

Below is the information in the DSS User Guide document.

pimchaya.wongrukun01

Hello @Axegine,

You can refer to REST API Reference Tree showing the complete functionality with the parameters of each function and the HTTP requests according to the parameters.

The example of TermsAndConditionsExtractionRequest parameters:

The example of TermsAndConditionsExtractionRequest request according to the Parameters

EXPLORE OUR SITES