> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finvera.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Income statements
> Retrieve standardized income statements with pagination and filters.
```json Response (200 OK) theme={null}
{
"next_url": "https://api.finvera.news/stocks/v1/fundamentals/income-statement?cursor=AAECAAFkAAEBB_ucng==",
"request_id": "570da25ecda04e8cb3bc9457d3bcf62e",
"results": [
{
"cik": "0000866729",
"consolidated_net_earnings": -71100000,
"cost_of_revenue": 123500000,
"depreciation_amortization_total": 16300000,
"earnings_per_share_basic": -2.83,
"earnings_per_share_diluted": -2.83,
"ebitda": -64900000,
"fiscal_quarter": 1,
"fiscal_year": 2026,
"gross_profit": 102100000,
"income_from_operations": -92200000,
"income_taxes": -25900000,
"interest_expense": -4500000,
"miscellaneous_operating_expenses": 800000,
"net_income_common_stockholders": -71100000,
"non_operating_income_expense": -300000,
"non_operating_items_net": -4800000,
"operating_expenses_total": 194300000,
"pre_tax_income": -97000000,
"reporting_period_end": "2025-08-31",
"revenue": 225600000,
"sales_general_admin_expenses": 177200000,
"symbols": [
"SCHL"
],
"timeframe": "quarterly",
"weighted_average_shares_basic": 25200000,
"weighted_average_shares_diluted": 25200000
},
{
"cik": "0000866729",
"consolidated_net_earnings": -10500000,
"cost_of_revenue": 714000000,
"depreciation_amortization_total": 66700000,
"earnings_per_share_basic": -0.69,
"earnings_per_share_diluted": -0.71,
"ebitda": 108300000,
"fiscal_quarter": 1,
"fiscal_year": 2026,
"gross_profit": 899900000,
"income_from_operations": 12100000,
"income_taxes": 4000000,
"interest_expense": -19700000,
"interest_income": 2200000,
"miscellaneous_operating_expenses": 3700000,
"net_income_common_stockholders": -10500000,
"non_operating_income_expense": -1100000,
"non_operating_items_net": -18600000,
"operating_expenses_total": 887800000,
"pre_tax_income": -6500000,
"reporting_period_end": "2025-08-31",
"revenue": 1613900000,
"sales_general_admin_expenses": 817400000,
"symbols": [
"SCHL"
],
"timeframe": "trailing_twelve_months",
"weighted_average_shares_basic": 27200000,
"weighted_average_shares_diluted": 27300000
}
],
"status": "OK"
}
```
## OpenAPI
````yaml get /v1/fundamentals/income-statement
openapi: 3.0.3
info:
title: Fundamentals
version: 1.1.0
description: >
REST API for standardized financial statements with pagination, filtering,
and sorting. Responses include cursor-based pagination links and metadata.
Timeframes support quarterly, annual, and trailing_twelve_months for cash
flows. [Do not include this bracketed note in production.]
servers:
- url: https://api.finvera.news/stocks
security:
- ApiKeyQuery: []
tags:
- name: Fundamentals
description: Financial statements endpoints
paths:
/v1/fundamentals/income-statement:
get:
tags:
- Fundamentals
summary: Income statements
description: Retrieve standardized income statements with pagination and filters.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Sort'
- $ref: '#/components/parameters/CIK'
- $ref: '#/components/parameters/Tickers'
- $ref: '#/components/parameters/PeriodEnd'
- $ref: '#/components/parameters/FiscalYear'
- $ref: '#/components/parameters/FiscalQuarter'
- $ref: '#/components/parameters/Timeframe'
responses:
'200':
description: Successful response
headers:
Connection:
schema:
type: string
example: keep-alive
Content-Encoding:
schema:
type: string
example: gzip
Content-Type:
schema:
type: string
example: application/json
Date:
schema:
type: string
example: Thu, 25 Sep 2025 15:31:03 GMT
Link:
schema:
type: string
example: >-
;
rel="next"
Strict-Transport-Security:
schema:
type: string
example: max-age=15724800; includeSubDomains
Vary:
schema:
type: string
example: Accept-Encoding
X-Content-Type-Options:
schema:
type: string
example: nosniff
X-Frame-Options:
schema:
type: string
example: SAMEORIGIN
X-Polygon-Cluster-Name:
schema:
type: string
example: polygon-ny5
X-Request-Id:
schema:
type: string
example: c84b9461003146779005d7e70123f13d
X-Xss-Protection:
schema:
type: string
example: 1; mode=block
Transfer-Encoding:
schema:
type: string
example: chunked
RateLimit-Limit:
$ref: '#/components/headers/RateLimit-Limit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimit-Remaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimit-Reset'
content:
application/json:
schema:
$ref: '#/components/schemas/PagedIncomeStatementResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
5XX:
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
parameters:
Limit:
name: limit
in: query
required: false
description: Max number of results to return per page (1–1000)
schema:
type: integer
minimum: 1
maximum: 1000
default: 100
example: 100
Sort:
name: sort
in: query
required: false
description: >
Sort by field and direction; format: field[.asc|.desc]. Default asc when
direction omitted. Supported fields: period_end, fiscal_year,
fiscal_quarter.
schema:
type: string
pattern: ^[a-z_]+(\.(asc|desc))?$
example: period_end.desc
CIK:
name: cik
in: query
required: false
description: Central Index Key as a zero-padded string of up to 10 digits
schema:
type: string
pattern: ^[0-9]{1,10}$
example: '0000320193'
Tickers:
name: tickers
in: query
required: false
description: Comma-separated list of symbols (e.g., AAPL,MSFT)
schema:
type: string
pattern: ^[A-Z0-9.,-]{1,200}$
example: AAPL
PeriodEnd:
name: period_end
in: query
required: false
description: Reporting period end date in yyyy-mm-dd
schema:
type: string
format: date
example: '2025-06-28'
FiscalYear:
name: fiscal_year
in: query
required: false
description: Fiscal year (four digits)
schema:
type: integer
minimum: 1900
maximum: 2100
example: 2025
FiscalQuarter:
name: fiscal_quarter
in: query
required: false
description: Fiscal quarter number
schema:
type: integer
enum:
- 1
- 2
- 3
- 4
example: 3
Timeframe:
name: timeframe
in: query
required: false
description: Reporting period type
schema:
type: string
enum:
- quarterly
- annual
- trailing_twelve_months
example: quarterly
headers:
RateLimit-Limit:
description: The number of allowed requests in the current window
schema:
type: integer
RateLimit-Remaining:
description: The number of remaining requests in the current window
schema:
type: integer
RateLimit-Reset:
description: Seconds until the rate limit window resets
schema:
type: integer
schemas:
PagedIncomeStatementResponse:
type: object
allOf:
- $ref: '#/components/schemas/CommonMeta'
- type: object
required:
- results
properties:
next_url:
type: string
format: uri
nullable: true
results:
type: array
items:
$ref: '#/components/schemas/IncomeStatementItem'
ErrorResponse:
type: object
required:
- request_id
- status
- error
properties:
request_id:
type: string
status:
type: string
enum:
- ERROR
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- bad_request
- unauthorized
- forbidden
- not_found
- rate_limited
- internal_error
- service_unavailable
message:
type: string
details:
type: object
additionalProperties: true
CommonMeta:
type: object
required:
- request_id
- status
properties:
request_id:
type: string
status:
type: string
enum:
- OK
additionalProperties: false
IncomeStatementItem:
type: object
required:
- cik
- fiscal_year
- reporting_period_end
- timeframe
- revenue
- symbols
properties:
cik:
type: string
pattern: ^[0-9]{1,10}$
symbols:
$ref: '#/components/schemas/SymbolArray'
fiscal_year:
type: integer
fiscal_quarter:
type: integer
enum:
- 1
- 2
- 3
- 4
nullable: true
reporting_period_end:
type: string
format: date
timeframe:
type: string
enum:
- quarterly
- annual
consolidated_net_earnings:
type: number
cost_of_revenue:
type: number
depreciation_amortization_total:
type: number
earnings_per_share_basic:
type: number
earnings_per_share_diluted:
type: number
ebitda:
type: number
gross_profit:
type: number
income_from_operations:
type: number
income_taxes:
type: number
interest_expense:
type: number
miscellaneous_operating_expenses:
type: number
net_income_common_stockholders:
type: number
non_operating_income_expense:
type: number
non_operating_items_net:
type: number
operating_expenses_total:
type: number
pre_tax_income:
type: number
revenue:
type: number
sales_general_admin_expenses:
type: number
weighted_average_shares_basic:
type: number
weighted_average_shares_diluted:
type: number
additionalProperties: false
SymbolArray:
type: array
items:
type: string
pattern: ^[A-Z0-9.-]{1,10}$
minItems: 1
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: apikey
description: API key in query string
````