Filed guidance
Guidance as the company filed it.
Parameters
symbolpathrequired
Ticker symbol, case-insensitive.
Response contract
Everything except the fields named as withheld, which are ours and not yours.
Withheld
model_version
These are ours: ingest bookkeeping and internal build stamps. They are removed at every level of the response, including inside arrays.
Response fields
The top level keys a live response actually returned, read off the API rather than written down here.
symbolavailablecitationstopics
How this was verified
Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.
Request
curl "https://api.massari.ai/v1/earnings/AAPL/guidance" \
-H "Authorization: Bearer $MASSARI_TOKEN"Example response
{
"symbol": "AAPL",
"available": true,
"citations": [
{
"filing_type": "10-K",
"filing_date": "2025-10-31",
"accession_number": "0000320193-25-000079",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
},
{
"filing_type": "10-Q",
"filing_date": "2026-07-31",
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
}
],
"topics": {
"revenue": [
{
"topic": "revenue",
"sentence": "As of June 27, 2026 and September 27, 2025, the Company had total deferred revenue of $ 14.9 billion and $ 13.7 billion, respectively.",
"dollars_usd": [
14900000000,
13700000000
],
"percents": [],
"target_years": [
2026
],
"section": "financial_statements",
"score": 0.2386183440685272,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
},
{
"topic": "revenue",
"sentence": "As of June 27, 2026, the Company expects 64 % of total deferred revenue to be realized in less than a year, 23 % within one-to-two years, 11 % within two-to-three years and 2 % in greater than three years.",
"dollars_usd": [],
"percents": [
64,
23
],
"target_years": [
2026
],
"section": "financial_statements",
"score": 0.2386183440685272,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
}
],
"eps": [
{
"topic": "eps",
"sentence": "As of June 27, 2026 and September 27, 2025, the Company had total deferred revenue of $ 14.9 billion and $ 13.7 billion, respectively.",
"dollars_usd": [
14900000000,
13700000000
],
"percents": [],
"target_years": [
2026
],
"section": "financial_statements",
"score": 0.21143871545791623,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
},
{
"topic": "eps",
"sentence": "As of June 27, 2026, the Company expects 64 % of total deferred revenue to be realized in less than a year, 23 % within one-to-two years, 11 % within two-to-three years and 2 % in greater than three years.",
"dollars_usd": [],
"percents": [
64,
23
],
"target_years": [
2026
],
"section": "financial_statements",
"score": 0.21143871545791623,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
}
],
"capex": [
{
"topic": "capex",
"sentence": "As of June 27, 2026, the Company had manufacturing purchase obligations of $57.0 billion, with $56.2 billion payable within 12 months.",
"dollars_usd": [
57000000000,
56200000000
],
"percents": [],
"target_years": [
2026
],
"section": "mda",
"score": 0.25526900558060417,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
},
{
"topic": "capex",
"sentence": "As of June 27, 2026, the Company had other purchase obligations of $29.3 billion, with $9.2 billion payable within 12 months.",
"dollars_usd": [
29300000000,
9200000000
],
"percents": [],
"target_years": [
2026
],
"section": "mda",
"score": 0.25526900558060417,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
}
],
"margin": [],
"capital_return": [
{
"topic": "capital_return",
"sentence": "As of June 27, 2026, the Company had manufacturing purchase obligations of $57.0 billion, with $56.2 billion payable within 12 months.",
"dollars_usd": [
57000000000,
56200000000
],
"percents": [],
"target_years": [
2026
],
"section": "mda",
"score": 0.3815198909330439,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
},
{
"topic": "capital_return",
"sentence": "As of June 27, 2026, the Company had other purchase obligations of $29.3 billion, with $9.2 billion payable within 12 months.",
"dollars_usd": [
29300000000,
9200000000
],
"percents": [],
"target_years": [
2026
],
"section": "mda",
"score": 0.3815198909330439,
"accession_number": "0000320193-26-000020",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
}
]
}
}A real response from the live API, captured August 18, 2026. This one is CUT: long arrays, wide objects and long strings were trimmed to keep it readable, so treat it as a sample of the shape rather than all of it. Either way it is valid JSON.