For a deeper look into our DataScope Select REST API, look into:

Overview |  Quickstart |  Documentation |  Downloads |  Tutorials

question

Upvotes
Accepted
1 0 1 3

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

dss-rest-apidssdatascope-selectterms-and-conditions
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Upvotes
Accepted
11.3k 25 8 14

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.


deltaextraction.png (91.3 KiB)
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Upvotes
18.1k 21 12 20

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"}]}
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Upvotes
9.5k 10 5 7

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


parameters.png (72.0 KiB)
httprequest.png (56.3 KiB)
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.