{"uid":"cap_F57zkCDPPpaSVp4w_tdXC","slug":"agentfilings-earnings-summary-4b87c0ee","name":"AgentFilings Earnings Summary","description":"Structured US SEC/EDGAR filing data for AI agents — filings, XBRL-derived earnings, and Form 4 insider transactions as clean JSON.","url":"https://api.agentfilings.com/earnings/summary?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"period":{"type":"string","description":"Optional filter: \"annual\" | \"quarterly\" | \"interim\", a fiscal year (\"2025\" or \"FY2025\"), or an SEC frame (\"CY2026Q1\")"},"ticker":{"type":"string","description":"Ticker symbol, e.g. AAPL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"count":1,"ticker":"AAPL","periods":[{"form":"10-Q","revenue":111184000000,"duration":"quarterly","filed_at":"2026-05-01","eps_basic":2.02,"net_income":29578000000,"period_end":"2026-03-28","eps_diluted":2.01,"fiscal_year":2026,"period_start":"2025-12-28","fiscal_period":"Q2","source_accession":"0000320193-26-000013"}]},"meta":{"cache":"miss","source_api":"sec-edgar-companyfacts","retrieved_at":"2026-07-26T01:35:41Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nUy48BRsm-ZFxO3caDWb2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured earnings summary data (revenue, net income, EPS) for a given US-listed stock ticker, sourced from SEC/EDGAR XBRL filings.","exampleAgentPrompt":"Pull the quarterly earnings summary for AAPL from AgentFilings — I need the revenue, net income, and EPS figures for Q2 fiscal year 2026.","exampleUseCases":[{"title":"Earnings snapshot for earnings call prep","prompt":"Get me the most recent quarterly earnings summary for NVDA — revenue, net income, and EPS — so I can prep talking points before the earnings call."},{"title":"Annual revenue trend for investor memo","prompt":"Pull Apple's annual earnings summaries for fiscal years 2023, 2024, and 2025 — I need the revenue and net income figures for each year for a quick investor memo."},{"title":"EPS comparison for stock screener","prompt":"What was Tesla's diluted EPS for Q3 2025? I want to compare it against analyst estimates for a screener I'm building."}],"resultDescription":"A JSON object containing an array of earnings periods for the requested ticker, each with revenue, net income, basic and diluted EPS, fiscal year, fiscal period label, period start/end dates, the SEC form type (e.g. 10-Q or 10-K), filing date, and source accession number. Also includes metadata about cache status and retrieval time.","failureModes":["Unknown or invalid ticker symbol returns empty results or an error","Ticker exists but has no XBRL-tagged filings on EDGAR (e.g. foreign private issuers)","Requested period filter returns no matching filings","Rate limiting or payment failure (x402) if USDC payment is not properly handled","Stale cache may return slightly delayed data vs. real-time EDGAR submissions"],"whenToPreferThis":"Use this endpoint when you need clean, structured earnings data (revenue, net income, EPS) derived directly from SEC EDGAR XBRL filings for US-listed companies. Prefer it over scraping financial news sites or using raw EDGAR APIs, as it returns normalized JSON with no parsing overhead. Ideal for AI agents that need to answer earnings questions, build financial summaries, or feed structured financial data into downstream analysis — especially when XBRL accuracy and SEC provenance are important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:36:12.900Z","isFirstParty":false,"canonicalSlug":"agentfilings-earnings-summary-4b87c0ee"}