> ## Documentation Index > Fetch the complete documentation index at: https://docs.capyfin.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a specific earning report. > Returns a single earning report by company slug and fiscal period. ## OpenAPI ````yaml api-reference/openapi.json get /v1/earnings-reports/{exchange}/{symbol}/{fiscalPeriod} openapi: 3.0.0 info: title: CapyFin API description: >- The CapyFin API provides access to earnings reports with financials, key takeaways, revenue breakdowns, and forward guidance, delivered through a powerful, developer-friendly API. For support or enterprise access, please contact us at support@capyfin.com. version: 1.0.0 contact: name: CapyFin Support url: https://capyfin.com/support email: support@capyfin.com servers: - url: https://api.capyfin.com description: CapyFin API security: - ApiKeyQuery: [] - ApiKeyHeader: [] tags: [] paths: /v1/earnings-reports/{exchange}/{symbol}/{fiscalPeriod}: get: tags: - Earnings Reports API summary: Get a specific earning report. description: Returns a single earning report by company slug and fiscal period. operationId: getReport parameters: - name: exchange required: true in: path description: The exchange of the instrument (e.g., nasdaq, nyse). schema: type: string - name: symbol required: true in: path description: The symbol of the instrument (e.g., aapl, tsla). schema: type: string - name: fiscalPeriod required: true in: path description: The fiscal period of the report (e.g. Q12024). schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/EarningsReportDto' components: schemas: EarningsReportDto: type: object properties: id: type: string description: The unique identifier for the earning report. example: 507f1f77bcf86cd799439011 fiscalPeriod: type: string description: The fiscal period of the report (e.g., Q12024, FY2023). example: Q12024 date: format: date-time type: string description: The release date of the earnings report. example: '2024-05-02T00:00:00.000Z' reportTime: type: string description: The time of day the report is released. enum: - amc - bmo - dm example: amc currency: type: string description: The currency of the report values. example: USD totalRevenue: type: number description: Total revenue reported. example: 94836000000 eps: type: number description: Earnings Per Share (EPS). example: 1.53 epsAdj: type: number description: Adjusted Earnings Per Share (Non-GAAP). example: 1.53 verified: type: boolean description: Whether the report has been verified. example: true employees: type: number description: Number of employees. example: 1000 instrument: description: The instrument associated with this report. allOf: - $ref: '#/components/schemas/InstrumentDto' netIncome: type: number description: Net Income. operatingIncome: type: number description: Operating Income. grossProfit: type: number description: Gross Profit. metrics: description: List of specific metrics for the report. type: array items: $ref: '#/components/schemas/EarningsReportMetric' summary: type: string description: Summary of the report. subtitle: type: string description: Subtitle of the report. keyTakeaways: description: Key takeaways from the report. type: array items: type: string forwardSummary: type: string description: Summary of forward guidance. forwardPositive: description: Positive points from forward guidance. type: array items: type: string forwardNegative: description: Negative points from forward guidance. type: array items: type: string callPositive: description: Positive points from the earnings call. type: array items: type: string callNegative: description: Negative points from the earnings call. type: array items: type: string required: - id - fiscalPeriod - date - instrument InstrumentDto: type: object properties: id: type: string description: The unique identifier for the instrument. example: 507f1f77bcf86cd799439011 slug: type: string description: URL-friendly identifier for the instrument. example: nasdaq-aapl symbol: type: string description: The ticker symbol of the instrument. example: AAPL name: type: string description: The short name of the instrument. example: Apple fullName: type: string description: The full name of the instrument. example: Apple Inc. image: type: string description: URL to the instrument logo/image. example: https://assets.capyfin.com/instruments/507f1f77bcf86cd799439011.png marketCap: type: number description: The total market capitalization of the company, in USD. example: 3587432814000 country: type: string description: The primary country of the company. example: US exchange: type: string description: The exchange on which the instrument is traded. example: nasdaq segments: description: Business segments of the company. type: array items: type: string geo: description: Geographic segments of the company. type: array items: type: string kpis: description: Key performance indicators for the company. type: array items: type: string investorRelationsUrl: type: string description: URL to the investor relations page. example: https://investor.apple.com closingPrice: type: number description: The last closing price of the instrument. example: 237.33 returnLastDay: type: number description: >- The return of the instrument over the last day, expressed as a percentage. example: 1.92 returnThisWeek: type: number description: >- The return of the instrument over the last week, expressed as a percentage. example: 3.24 return2Years: type: number description: >- The return of the instrument over the last two years, expressed as a percentage. example: 54.771 return5Years: type: number description: >- The return of the instrument over the last five years, expressed as a percentage. example: 281.63 returnAll: type: number description: >- The return of the instrument since inception (all time), expressed as a percentage. example: 1432.26 dividendYield: type: number description: The dividend yield as a percentage. example: 0.4171 dividendExDate: format: date-time type: string description: The ex-dividend date for the upcoming dividend payment. example: '2024-11-08T00:00:00.000Z' dividendPayDate: format: date-time type: string description: The date on which the dividend will be paid. example: '2024-11-14T00:00:00.000Z' dividendUsd: type: number description: The dividend amount to be paid per share, in USD. example: 0.25 dividendFrequency: type: string description: The frequency of dividend payments. example: QUARTERLY dividendYearly: type: object description: >- Dividends per share during each year (in dollars). Map year -> amount. example: '2023': 0.94 '2024': 0.97 closeYearly: type: object description: Closing prices at the end of each year. Map year -> price. example: '2023': 192.53 '2024': 237.33 required: - id - slug - symbol - name - fullName - exchange EarningsReportMetric: type: object properties: {} securitySchemes: ApiKeyQuery: type: apiKey in: query name: apikey description: >- Pass your API key as a query parameter (e.g., /endpoint?apikey=YOUR_API_KEY) ApiKeyHeader: type: apiKey in: header name: Authorization description: >- Pass your API key as a Bearer token in the header (e.g., Authorization: Bearer YOUR_API_KEY) ````