from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.financials.get_income_statements()
while res is not None:
# Handle items
res = res.next()import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.financials.getIncomeStatements();
for await (const page of result) {
console.log(page);
}
}
run();curl --request GET \
--url https://api.aries.com/v1/financials/income-statements \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/financials/income-statements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/financials/income-statements",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/financials/income-statements"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/financials/income-statements")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/financials/income-statements")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"nextUrl": "https://api.aries.com/v1/financials/income-statements?limit=5&next=AiYPBEFBUEwpDwlxdWFydGVybHkCAgABAQABAQUAAgEJ-_B0AQ8KMDAwMDMyMDE5Mw%3D%3D&tickersAnyOf=AAPL&timeframe=quarterly",
"requestId": "87fbffe186684ff1a4297e43d17fa8f7",
"results": [
{
"basicEarningsPerShare": 0.13,
"basicSharesOutstanding": 25299176000,
"cik": "0000320193",
"consolidatedNetIncomeLoss": 3378000000,
"costOfRevenue": 9272000000,
"dilutedEarningsPerShare": 0.13,
"dilutedSharesOutstanding": 25753924000,
"ebitda": 4934000000,
"filingDate": "2011-01-19",
"fiscalQuarter": 1,
"fiscalYear": 2010,
"grossProfit": 6411000000,
"incomeBeforeIncomeTaxes": 4758000000,
"incomeTaxes": 1380000000,
"netIncomeLossAttributableCommonShareholders": 3378000000,
"operatingIncome": 4725000000,
"otherIncomeExpense": 33000000,
"otherOperatingExpenses": 0,
"periodEnd": "2009-12-26",
"researchDevelopment": 398000000,
"revenue": 15683000000,
"sellingGeneralAdministrative": 1288000000,
"tickers": [
"AAPL"
],
"timeframe": "quarterly",
"totalOperatingExpenses": 1686000000,
"totalOtherIncomeExpense": 33000000
}
],
"status": "OK"
}Income Statements
Retrieve SEC income statement rows by filing period. Filter by CIK, tickers, filing and period dates, fiscal year and quarter, timeframe, and pagination.
Use Case: Pull revenue, operating income, margins, and EPS-related lines for a company across quarterly or annual filings.
from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.financials.get_income_statements()
while res is not None:
# Handle items
res = res.next()import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.financials.getIncomeStatements();
for await (const page of result) {
console.log(page);
}
}
run();curl --request GET \
--url https://api.aries.com/v1/financials/income-statements \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/financials/income-statements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/financials/income-statements",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/financials/income-statements"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/financials/income-statements")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/financials/income-statements")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"nextUrl": "https://api.aries.com/v1/financials/income-statements?limit=5&next=AiYPBEFBUEwpDwlxdWFydGVybHkCAgABAQABAQUAAgEJ-_B0AQ8KMDAwMDMyMDE5Mw%3D%3D&tickersAnyOf=AAPL&timeframe=quarterly",
"requestId": "87fbffe186684ff1a4297e43d17fa8f7",
"results": [
{
"basicEarningsPerShare": 0.13,
"basicSharesOutstanding": 25299176000,
"cik": "0000320193",
"consolidatedNetIncomeLoss": 3378000000,
"costOfRevenue": 9272000000,
"dilutedEarningsPerShare": 0.13,
"dilutedSharesOutstanding": 25753924000,
"ebitda": 4934000000,
"filingDate": "2011-01-19",
"fiscalQuarter": 1,
"fiscalYear": 2010,
"grossProfit": 6411000000,
"incomeBeforeIncomeTaxes": 4758000000,
"incomeTaxes": 1380000000,
"netIncomeLossAttributableCommonShareholders": 3378000000,
"operatingIncome": 4725000000,
"otherIncomeExpense": 33000000,
"otherOperatingExpenses": 0,
"periodEnd": "2009-12-26",
"researchDevelopment": 398000000,
"revenue": 15683000000,
"sellingGeneralAdministrative": 1288000000,
"tickers": [
"AAPL"
],
"timeframe": "quarterly",
"totalOperatingExpenses": 1686000000,
"totalOtherIncomeExpense": 33000000
}
],
"status": "OK"
}Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Scopes
News, company profiles, financials, filings, ETF data, technical analysis
Query Parameters
Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
Comma-separated CIKs (maps to cik.any_of)
CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
CIK greater than or equal (inclusive)
CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
Exact fiscal period-end date filter. Use it to return statements for one reporting period.
Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
Fiscal period-end start filter. Returns records on or after this date.
Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
Fiscal period-end end filter. Returns records on or before this date.
Exact filing date filter. Use it to return filings submitted on one specific date.
Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
Filing-date start filter. Returns records on or after this date.
Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
Filing-date end filter. Returns records on or before this date.
Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
Ticker all-of filter. Return records that include all listed tickers.
Ticker any-of filter. Return records that include at least one listed ticker.
Exact fiscal year filter. Use it to return statements for one reporting year.
Fiscal year greater than (exclusive)
Fiscal year greater than or equal (inclusive)
Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
Fiscal year less than or equal (inclusive)
Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
Fiscal quarter greater than (exclusive)
Fiscal quarter greater than or equal (inclusive)
Fiscal quarter less than (exclusive)
Fiscal quarter less than or equal (inclusive)
Reporting timeframe (e.g. quarterly, annual)
Timeframe any-of filter. Return records that match at least one listed timeframe.
Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
Timeframe greater than or equal (inclusive)
Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
Timeframe less than or equal (inclusive)
Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
Max ticker any-of filter. Return records matching at least one listed maxTicker value.
Max ticker greater than (exclusive)
Max ticker greater than or equal (inclusive)
Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
Max ticker less than or equal (inclusive)
Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
Min ticker any-of filter. Return records matching at least one listed minTicker value.
Min ticker greater than (exclusive)
Min ticker greater than or equal (inclusive)
Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
Min ticker less than or equal (inclusive)
Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
x >= 1A comma-separated list of sort columns. For each column, append .asc or .desc to specify direction. Defaults to period_end.asc when not specified.
Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
Response
Successful response with one or more SEC income statement rows, status, request id, and optional nextUrl for pagination.
Paginated SEC income statements (results, status, requestId, nextUrl).
URL for the next page when more results exist
Provider request identifier. Include this when reporting data issues to support.
Income statement rows for the requested filters. Use these to analyze revenue, expenses, and profitability.
Show child attributes
Show child attributes
Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.
Was this page helpful?