DSS REST API - Starmine
Can you please explain why I get a response which does not reference the identifier I actually requested and tell me how to fix this? This makes it basically impossible for me to pull out the data for what I requested (obviously it’ll work for a single identifier, but not for more than one…)
e.g.
{
"ExtractionRequest": {
"@odata.type":
"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.StarmineExtractionRequest",
"IdentifierList": {
"@odata.type":
"#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.EntityIdentifierList",
"EntityIdentifiers": [{
"Identifier": "JHE42UYNWWTJB8YTTU19",
"IdentifierType": "Lei"
}]
},
"ContentFieldNames": ["Official Name",
"Credit SmartRatios Implied Rating"]
}}
Results in
{<br>
"@odata.context": "<a href="https://urldefense.proofpoint.com/v2/url?u=https-3A__hosted.datascopeapi.reuters.com_RestApi_v1_-24metadata-23ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.ExtractionResult&d=CwMFAg&c=4ZIZThykDLcoWk-GVjSLm9hvvvzvGv0FLoWSRuCSs5Q&r=czdPXU3OhjgtXPAuxk0a-TfZt8RUQeV5jW6_ic5HRNQ&m=XHGBdTRWtilM4fzK3PpGuRdt-pVyrlAnmOAPKQ6ICNs&s=1LT8dkOG5NbJWTdRQnzawhjpWCKQP3BkrYjigZwxcOE&e=">https://hosted.datascopeapi.reuters.com/RestApi/v1/$metadata#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.ExtractionResult</a>",<br>
"Contents": [{<br><strong>
"IdentifierType": "OrgId",<br></strong><strong>
"Identifier": "17092",<br></strong>
"Official Name": "AUSTRALIA AND NEW ZEALAND BANKING GROUP
LIMITED",<br>
"Credit SmartRatios Implied Rating": "BBB"<br>
}],<br>
"Notes": [{removed to protect client info.}]<br>}"
Hello Gareth,
Thank you for your participation in the forum. Are any of the replies below satisfactory in resolving your query?
If yes please click the 'Accept' text next to the reply. This will guide all community members who have a similar question.
Hi Gareth - Yes, easy solution is for client to include Instrument ID/Type in their report template for extraction. That will always return the original ID they submitted no matter what the identifier resolves to after validation.
This does appear to be a bug of sorts, but today is a U.S. holiday and so I cannot work it out for sure until tomorrow. In the meantime, you can also add the identifier as a User DefinedIdentifier and then do your matching on that field (which does come back correctly).
Here is a sample of a entity validation call I made like this:
POST https://hosted.datascopeapi.reuters.com/RestApi/v1/Extractions/EntityListValidateIdentifiers HTTP/1.1
{"InputsForValidation":[{"Identifier":"JHE42UYNWWTJB8YTTU19","IdentifierType":"Lei","UserDefinedIdentifier":"JHE42UYNWWTJB8YTTU19"}],"KeepDuplicates":true,"IncludeParentAndUltimateParent":true}
Returned:
{"@odata.context":"https://hosted.datascopeapi.reuters.com/RestApi/v1/$metadata#ThomsonReuters.Dss.Api.Extractions.SubjectLists.EntitiesValidateIdentifiersResult","ValidatedEntities":[{"Identifier":"17092","IdentifierType":"OrgId","UserDefinedIdentifier":"JHE42UYNWWTJB8YTTU19","Key":"VjF8MHgwMDAzZWYwNmMwYmVmYjZmfEVORU58MTcwOTJ8T1JH","Description":"AUSTRALIA AND NEW ZEALAND BANKING GROUP LIMITED","InstrumentType":"Entity"}],"ValidationResult":{"ValidEntityCount":1,"ValidationDuplicates":[],"Messages":[]}}
Hi Rick,
I think the correct identifier is pulled into the output "Instrument ID" and "Instrument ID Type" but the client would need to add these in. Is this the best solution at the moment?
Best regards,
Gareth