Download 10-K filings and time of receipt with Filings API

Options
JHaddinga
JHaddinga Newcomer
edited June 12 in Refinitiv Data Platform

Hi, I had a question on using the Filings API (described here: https://developers.lseg.com/en/article-catalog/article/introduction-to-filings---python) : Is it possible to download both the document and its metadata at the same time?

I need to download the 10-K filings for multiple companies and also need the exact time when they were filed. In LSEG Workspace I can see the "Receipt Date" (which also carries the exact time) and I was wondering whether this information can be retrieved by the API as well. (It's fine if document and metadata cannot be downloaded simultaneously: I would then link both together by using the DCN)

If not, how can I access it? When I go through the Advanced Filings in LSEG Workspace, I cannot see an option to download the table which carries the Receipt Date (only the documents themselves). It would also be enough if the time could be added to the title of the downloaded document (but this also seems unavailable).

Thanks for your help.

Tagged:

Answers

  • Jirapongse
    Jirapongse ✭✭✭✭✭

    @JHaddinga

    Thank you for reaching out to us.

    This could be the OnPremDateReceived field in the DocumentSummary.

        FilingDocument {
    
          Identifiers {
    
            OrganizationId
    
            Dcn
    
          }
    
          DocId
    
          FinancialFilingId
    
          DocumentSummary {
    
            DocumentTitle
    
            FeedName
    
            FormType
    
            HighLevelCategory
    
            MidLevelCategory
    OnPremDateReceived
            FilingDate         SecAccessionNumber         SizeInBytes       }       FilesMetaData {         FileName         MimeType       }     }   }
  • JHaddinga
    JHaddinga Newcomer

    Ok. And is it possible to retrieve these time stamps/dates also with the API for LSEG Workspace (in case I don't need the documents themselves) or would that require a different product?

  • Jirapongse
    Jirapongse ✭✭✭✭✭

    @JHaddinga

    Please check the available fields of the FinancialFilings_DocumentSummary from the https://api.refinitiv.com/data-store/v1/schema/sdl endpoint.

    image.png
  • JHaddinga
    JHaddinga Newcomer

    Ok. And where would I find that - can you please provide me an URL?

    I cannot open the API-link you provided above (it says I do not have authorization to visit the page)

  • Jirapongse
    Jirapongse ✭✭✭✭✭

    @JHaddinga

    You need to specify an access token in the header when accessing the data platform endpoint. For example.

    curl --location "https://api.refinitiv.com/data-store/v1/schema/sdl" --header "Authorization: Bearer <token"
    

    Otherwise, you can access it from the API doc.