Balance Sheets

get

https://api.bavest.co/v2/equities/balance-sheets

Returns annual or quarterly balance sheet statements with full line-item detail.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

symbol

string

Stock ticker symbol (e.g., AAPL, MSFT, GOOGL). Provide exactly one of symbol or isin.

isin

string

length between 12 and 12

^[A-Z]{2}[A-Z0-9]{9}[0-9]$

ISIN code (e.g., US0378331005). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

freq

string

enum

Defaults to annual

Reporting frequency

Allowed:

provenance

boolean

Defaults to false

When true, the response carries a provenance block with one entry per served statement date: where the numbers come from, when we got them, and whether they changed since. Entries are explicit nulls while ledger coverage has not begun for the security.

fields

string

Comma-separated list of balance sheet line items to include. When provided, each statement is reduced to the named line items. Names that are not balance sheet line items match nothing, so a statement reduced by them comes back empty. Example when explicitly filtering: totalAssets,totalLiabilities,totalEquity.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).

401Missing or invalid API key.

404Resource not found.

429Rate limit exceeded. Retry after the Retry-After header interval.

500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.

502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.

504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.

defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.