# Get a list of earning reports.
Source: https://docs.capyfin.com/api-reference/earnings-reports-api/get-a-list-of-earning-reports

api-reference/openapi.json get /v1/earnings-reports/{exchange}/{symbol}
Returns a paginated list of earning reports for a specific instrument.



# Get a list of earning reports filtered by date.
Source: https://docs.capyfin.com/api-reference/earnings-reports-api/get-a-list-of-earning-reports-filtered-by-date

api-reference/openapi.json get /v1/earnings-reports
Returns a paginated list of earning reports within a date range.



# Get a specific earning report.
Source: https://docs.capyfin.com/api-reference/earnings-reports-api/get-a-specific-earning-report

api-reference/openapi.json get /v1/earnings-reports/{exchange}/{symbol}/{fiscalPeriod}
Returns a single earning report by company slug and fiscal period.



# Get a list of instruments.
Source: https://docs.capyfin.com/api-reference/instruments-api/get-a-list-of-instruments

api-reference/openapi.json get /v1/instruments
Returns a paginated list of instruments.



# Get Instrument by Slug
Source: https://docs.capyfin.com/api-reference/instruments-api/get-instrument-by-slug

api-reference/openapi.json get /v1/instruments/{exchange}/{symbol}
Retrieve a single instrument by its exchange and symbol (slug format: exchange/symbol).



# Get Instrument by Symbol
Source: https://docs.capyfin.com/api-reference/instruments-api/get-instrument-by-symbol

api-reference/openapi.json get /v1/instruments/{symbol}
Retrieve a single instrument by its symbol.



# Get segments data for a company.
Source: https://docs.capyfin.com/api-reference/segments-api/get-segments-data-for-a-company

api-reference/openapi.json get /v1/segments/{exchange}/{symbol}
Returns time-series data for revenue, EPS, business segments, and geographic regions.



# Introduction
Source: https://docs.capyfin.com/index

Start building with the CapyFin API

Welcome to the **CapyFin API** documentation. CapyFin provides programmatic access to rich earnings report data, including financials, key takeaways, segment breakdowns, and forward guidance.

<Info>
  **Prerequisite**: You need an API Key to authenticate your requests. You can generate one in the [Developer
  Dashboard](https://capyfin.com/api/dashboard).
</Info>

## Authentication

All API requests must be authenticated using your API key. You can pass the key in one of two ways:

### 1. Header (Recommended)

Include the header `Authorization: Bearer YOUR_API_KEY` in your requests.

```bash theme={null}
curl "https://api.capyfin.com/v1/instruments/nasdaq/aapl" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 2. Query Parameter

Append `?apikey=YOUR_API_KEY` to the URL.

```bash theme={null}
curl "https://api.capyfin.com/v1/instruments/nasdaq/aapl?apikey=YOUR_API_KEY"
```

## Base URL

All API requests should be made to the following base URL:

```bash theme={null}
https://api.capyfin.com
```

## Get Started

<CardGroup>
  <Card title="Get your API Key" icon="key" href="https://capyfin.com/api/dashboard">
    Create an account and generate your API key to start making requests.
  </Card>

  <Card title="Explore the API" icon="code" href="/api-reference">
    Browse our endpoints to retrieve instruments, earnings reports, segments, and more.
  </Card>
</CardGroup>