US company income statements
financialdatasets.financials.income-statementsGet standardized annual, quarterly or trailing income statements for a US public company
- Price
- $0.02/successPelo preço do provedor
- Success rate
- —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
- Latency p50
- ——
- Last verified
- 15 de set. de 2026Verified working
GEThttps://toolswitch.dev/v1/tools/financialdatasets.financials.income-statements?limit=1&period=annual&ticker=AAPLPreview- Uses platform quota
- Synchronous response
- Reads public data
Parâmetros
Supply ticker or cik unless continuing with cursor.
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de consulta | ||||
cik | string | Opcional | SEC Central Index Key; supply ticker or cik | |
limit | inteiro | Opcional | 1 | |
cursor | string | Opcional | opaque cursor from the response next_page_url; when supplied, omit the original filters because the cursor preserves them | |
period | string | Obrigatório | annual | quarterly | ttm | annual |
ticker | string | Opcional | US stock ticker; supply ticker or cik | AAPL |
filing_date | string | Opcional | exact filing date, YYYY-MM-DD | |
report_period | string | Opcional | exact report date, YYYY-MM-DD | |
filing_date_gt | string | Opcional | filing date after YYYY-MM-DD | |
filing_date_lt | string | Opcional | filing date before YYYY-MM-DD | |
filing_date_gte | string | Opcional | filing date on or after YYYY-MM-DD | |
filing_date_lte | string | Opcional | filing date on or before YYYY-MM-DD | |
report_period_gt | string | Opcional | report date after YYYY-MM-DD | |
report_period_lt | string | Opcional | report date before YYYY-MM-DD | |
report_period_gte | string | Opcional | report date on or after YYYY-MM-DD | |
report_period_lte | string | Opcional | report date on or before YYYY-MM-DD | |
- Parâmetros de consulta
cikstringOpcionalSEC Central Index Key; supply ticker or cik
limitinteiroOpcionalExemplo:
1cursorstringOpcionalopaque cursor from the response next_page_url; when supplied, omit the original filters because the cursor preserves them
periodstringObrigatórioannual | quarterly | ttm
Exemplo:
annualtickerstringOpcionalUS stock ticker; supply ticker or cik
Exemplo:
AAPLfiling_datestringOpcionalexact filing date, YYYY-MM-DD
report_periodstringOpcionalexact report date, YYYY-MM-DD
filing_date_gtstringOpcionalfiling date after YYYY-MM-DD
filing_date_ltstringOpcionalfiling date before YYYY-MM-DD
filing_date_gtestringOpcionalfiling date on or after YYYY-MM-DD
filing_date_ltestringOpcionalfiling date on or before YYYY-MM-DD
report_period_gtstringOpcionalreport date after YYYY-MM-DD
report_period_ltstringOpcionalreport date before YYYY-MM-DD
report_period_gtestringOpcionalreport date on or after YYYY-MM-DD
report_period_ltestringOpcionalreport date on or before YYYY-MM-DD
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X GET 'https://toolswitch.dev/v1/tools/financialdatasets.financials.income-statements?limit=1&period=annual&ticker=AAPL' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/financialdatasets.financials.income-statements?limit=1&period=annual&ticker=AAPL",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/financialdatasets.financials.income-statements?limit=1&period=annual&ticker=AAPL", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.02/success, incluindo a taxa de serviço.