{"id":679,"date":"2021-03-10T13:27:25","date_gmt":"2021-03-10T13:27:25","guid":{"rendered":"https:\/\/eodhd.com\/knowledgebase\/?p=679"},"modified":"2026-08-19T10:27:27","modified_gmt":"2026-08-19T08:27:27","slug":"calendar-upcoming-earnings-ipos-and-splits","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/calendar-upcoming-earnings-ipos-and-splits","title":{"rendered":"Calendar API: Upcoming Dividends, Earnings, Trends, IPOs and Splits"},"content":{"rendered":"\n

The Corporate Events Calendar covers the scheduled events that move a price: earnings reports, analyst estimate revisions, IPOs, stock splits and dividend dates. Five endpoints sit under the same \/api\/calendar\/ prefix and the same access right, each answering a different question, and each carrying history as well as what is still scheduled.<\/p>\n\n\n\n

\n
Endpoint<\/th>What it answers<\/th>Coverage measured in August 2026<\/th><\/tr><\/thead>
\/api\/calendar\/earnings<\/td>Who reports when, with actual EPS against the consensus estimate<\/td>Back to the 1990s, and 26,414 reports already scheduled between today and the end of 2027 \u2014 dense through March 2027, thinning to a handful after that<\/td><\/tr>\n
\/api\/calendar\/trends<\/td>Consensus EPS and revenue estimates, and how they have been revised<\/td>About 96 records per symbol for a large US name, anchored on fiscal periods from 2017 to 2027<\/td><\/tr>\n
\/api\/calendar\/ipos<\/td>Filings, expected listings and priced deals<\/td>Continuous from February 2013, plus an isolated batch of 84 deals in early 2010. Forward visibility is short \u2014 about three weeks<\/td><\/tr>\n
\/api\/calendar\/splits<\/td>Effective split and reverse-split ratios<\/td>Continuous from February 2013, plus 134 records in the first quarter of 2010. Announced splits reach into February 2027<\/td><\/tr>\n
\/api\/calendar\/dividends<\/td>Dividend dates for a symbol or a single day<\/td>Deep history and forward dates both \u2014 Apple’s 92 dividend dates start on 1987-05-11, and 347 symbols already carried a date on 2026-09-15<\/td><\/tr>\n<\/tbody><\/table><\/figure>\n\n\n\n

Those counts were measured on 18 August 2026 and grow with the feed. The calendar is part of the Fundamentals Data Feed<\/strong> and All-In-One<\/strong> plans, and is also sold on its own together with the news feed as Corporate Events Calendar & News Feed<\/a>. Every request across all five endpoints costs one API call<\/strong>, whatever the size of the window.<\/p>\n\n\n\n\n\n

\n <\/svg><\/span>\n
\n\n

Read this before your first request: on the earnings and splits endpoints the symbols<\/strong> parameter narrows a date window rather than replacing it, and when you omit from and to that window silently defaults to today through today + 7 days<\/strong>. A request for a single ticker with no dates therefore comes back with an empty list \u2014 the company almost certainly has no event in the next week. Always pass from and to alongside symbols. At the other end of the scale, more than ten years between the two bounds returns HTTP 422 with “Maximum date range is 10 years” on earnings, IPOs and splits alike \u2014 though that check is skipped when symbols is present, so a symbols query can span the whole archive.<\/p>\n\n<\/div>\n <\/div>\n \n\n\n

<\/div>\n\n\n\n

Earnings<\/h2>\n\n\n
\n
https:\/\/eodhd.com\/api\/calendar\/earnings?from=2025-01-01&to=2025-01-31&api_token=YOUR_API_TOKEN&fmt=json<\/code><\/pre>\n<\/div>\n\n\n
Reported and upcoming earnings, one record per company and fiscal period, with the actual EPS, the consensus estimate and the surprise already worked out for you.<\/p>\n\n\n\n
Parameters<\/h4>\n\n\n
\n    \n
\n    
\n                    api_token<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Your EODHD API token<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    from<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Start of the window, YYYY-MM-DD, matched against the report date. An unparseable value returns HTTP 422<\/span>\n                    (Default: today)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    to<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        End of the window, YYYY-MM-DD. Pass from alone and to becomes from + 7 days; pass to alone and from becomes today<\/span>\n                    (Default: from + 7 days)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    symbols<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        One or more tickers in EODHD format, comma-separated, for example AAPL.US,MSFT.US,AI.PA. This filters the date window, it does not replace it \u2014 combine it with from and to<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    fmt<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Response format. Allowed values: json, csv. Omitting the parameter returns CSV, whose column names differ from the JSON field names \u2014 Code, Report_Date, BeforeAfterMarket<\/span>\n                    (Default: csv)<\/em><\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n    
\n        <\/svg><\/span>\n        
\n\n
A window whose end precedes its start is not rejected: it returns HTTP 200 with an empty list. A symbol that does not exist, however, returns HTTP 404<\/strong> with a body complaining about a missing “type” \u2014 a misleading message that means the ticker was not found. When you pass symbols the response echoes the symbols back instead of the from and to you used, and records are grouped by ticker; in a plain date window they arrive sorted by report date, one record per company and fiscal period, with no duplicates.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n    
\n        <\/svg><\/span>\n        
\n\n
Keep earnings windows short. Nothing here is paginated, and this is the largest of the five datasets: one year is about 120,000 records and 21 MB, and a six-year window came back as a 158 MB<\/strong> payload after 45 seconds. Beyond roughly five years the request often fails outright with HTTP 500 and a bare “Error occurred” body, returned within ten seconds \u2014 the same window can succeed on one attempt and fail on the next, so treat the ten-year ceiling as a validation limit rather than a workable size. Slice long histories by month or quarter, or pass symbols to pull one company’s full record instead.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n\n
Request Example<\/h4>\n\n\n    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n