question

Upvotes
Accepted
3 1 1 2

Using Eikon API to retrieve the filing dates of annual reports and ESG reports

I am trying to retrieve the filing dates of annual reports and ESG reports using a search query similar to https://community.developers.refinitiv.com/questions/95582/eikon-api-retrieve-annual-report-publication-date.html, and I've met several confusing issues.

api_key = 'my api key'
ek.set_app_key(api_key)

isin_df = pd.read_csv('my path/retrieve dates/ isin_list.csv')
isin_list = isin_df['isin'].tolist()

fields = [
    'TR.ISSourceDate', 'TR.ISSource', 'TR.ISOriginalAnnouncementDate', 'TR.ISPeriodEndDate', 'TR.ISPeriodEndDate.fpa'
]

params = {'SDate': '2000-01-01', 'EDate': '2022-07-05'}

try:
    # retrieve data
    df, err = ek.get_data(instruments=isin_list, fields=fields, parameters=params)
    
    if df is None or err is not None:
        raise ValueError("API request failed or returned None. Error: {}".format(err))
    
    # print results
    print(df)

This is a sample of my code, I am using Python under MacOS.

1. Similar to the problem met by @researcher2, the search query gave me some dates different from the search results in Refinitiv workspace. Take Apple Inc. as an example, the data retrieved by the search query is like:

1719201076347.png

However, the dates retrieved are quite different to the results I found in the Refinitiv workspace.

1719201259530.png

Comparing the two snapshots, only the 'income statement period end date' and 'document date' are exactly the same. But for the others, I cannot tell whether the 'income statement source date' corresponds to 'receipt date' or 'filing date'. I am wondering is this the correct search query for retrieving filing dates, or due to I didn't get the right dates in Refinitiv workspace?

2. For the sustainability/ESG reports, I want all filing dates for the files under the 'company filings - company periodic reports - ESG disclosure' category. Where can I find the corresponding field names for retrieving ESG report filing dates?


Thanks for any help!

eikon-data-api#contentpython apiesgdatereports
1719201076347.png (168.0 KiB)
1719201259530.png (352.8 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.

1 Answer

· Write an Answer
Upvotes
Accepted
87.5k 294 53 79

@georgelocw

Thank you for reaching out to us.

As this forum is more for programming type queries, rather than content queries - I would recommend you raise a 'I need help understanding content within the product' ticket with our helpdesk.

That way a Content specialist can work closely with you and verify the assumption.

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.

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

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