curl --request GET \
--url https://api.aisa.one/apis/v1/financial/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/financial/financials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/financial/financials', 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.aisa.one/apis/v1/financial/financials",
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.aisa.one/apis/v1/financial/financials"
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.aisa.one/apis/v1/financial/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/financial/financials")
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{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
},
"next_page_url": "<string>"
}Get Financial Statements
All three financial statements for one company in a single call.
curl --request GET \
--url https://api.aisa.one/apis/v1/financial/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/financial/financials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/financial/financials', 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.aisa.one/apis/v1/financial/financials",
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.aisa.one/apis/v1/financial/financials"
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.aisa.one/apis/v1/financial/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/financial/financials")
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{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
},
"next_page_url": "<string>"
}financials object holding income_statements, balance_sheets and cash_flow_statements, each the same shape the dedicated tools return. period is required (annual, quarterly or ttm); identify the company by ticker or cik and cap with limit. Use it when you need the full picture and would otherwise make three calls. When you only need one statement, get_financial_financials_income_statements, get_financial_financials_balance_sheets or get_financial_financials_cash_flow_statements returns far less data; when you need a handful of named fields across several companies, post_financial_financials_search_line_items is narrower still.
https://mcp.aisa.one/mcp — Claude
Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
opens a browser, you click Allow once, and there is no key to paste. Your
agent then reaches every endpoint through five tools: search,
list_categories and get_details are free, use and batch_use are
billed per call. Setup per client is in
Connect via MCP; the live tool list and what each call
costs are on aisa.one/mcp.Cost and request rules
Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.02
- Cost contract: fixed_success
- Published reference multiplier: 1.0
- Settlement evidence source: request_snapshot
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The Central Index Key (CIK) of the company.
Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.
Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.
The maximum number of financial statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.
The time period of the financial statements.
annual, quarterly, ttm Filter by exact report period date in YYYY-MM-DD format.
Filter by report period greater than date in YYYY-MM-DD format.
Filter by report period greater than or equal to date in YYYY-MM-DD format.
Filter by report period less than date in YYYY-MM-DD format.
Filter by report period less than or equal to date in YYYY-MM-DD format.
The ticker symbol. Required if cik is not provided.