Get earnings report data (returns an array; query by company or by filing date)
Returns reported earnings results, filtered by `ticker`, `cik`, `year`, `quarter` or filing `date`. For dates of upcoming reports use /earningscalendar.
Example code
// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";
const orthogonal = new Orthogonal({
apiKey: process.env.ORTHOGONAL_API_KEY,
});
const output = await orthogonal.run({
api: "api-ninjas",
path: "/v2/earnings"
});
console.log(output);Query parameters
Company ticker symbol (e.g., ADBE). Use ticker or cik to query a company, or query by date with no ticker.
Company Central Index Key (e.g., 796343). Alternative to ticker for identifying a company.
Fiscal period (q1, q2, q3, q4, or fy). Requires a ticker/cik and year. (Allowed: q1, q2, q3, q4, fy)
Fiscal quarter 1-4 (alternative to period). Requires ticker/cik and year.
Fiscal year (e.g. 2024). With a ticker and no period/quarter, returns every period for that year; with period/quarter, one filing.
Return every filing whose SEC filing date equals this date (YYYY-MM-DD). Works with no ticker.
Start of a filing-date range (YYYY-MM-DD): all companies that filed on/after this date.
End of a filing-date range (YYYY-MM-DD). Combine with date_start to page through a window.
Number of results to skip for pagination. Results are returned 50 per page. Default is 0. (Default: 0)