Authenticating

Every API call to the endpoints below requires a valid API key to be provided. This API key verifies your permission to use the service. API keys are free! Get your own by registering for an account.

How to provide your key

Your key will look like this: 333acb16de254844ab64783232d2ba66

Include your API key as a header to your request with the label 'key'

Stock Data

Access data for any publicly traded security, including stock, bonds, options, crypto, and more.

Stock Data

Access summary or statistical data for stocks, bonds, options, crypto, and more.

GET
https://api.aletheiaapi.com/StockData

Parameters

Required
symbol - the symbol of the security you are requesting data for.
Optional
summary - Specifies if you would like to have stock summary data returned in the payload. Either 'true' or 'false'.
Optional
statistics - Specifies if you would like to have stock statistical data returned in the payload. Either 'true' or 'false'.

Example Requests

https://api.aletheiaapi.com/StockData?symbol=msft&summary=true
https://api.aletheiaapi.com/StockData?symbol=msft&summary=true&statistics=true
https://api.aletheiaapi.com/StockData?symbol=aapl&summary=false&statistics=true
+ Example Response
{
"Symbol": "PG",
"Summary": {
"Name": "The Procter & Gamble Company",
"StockSymbol": "PG",
"Price": 123.53,
"DollarChange": -3.05,
"PercentChange": -0.0241,
"PreviousClose": 126.58,
"Open": 126.54,
"BidPrice": 123.36,
"BidQuantity": 900,
"AskPrice": 123.55,
"AskQuantity": 1200,
"DayRangeLow": 121.82,
"DayRangeHigh": 126.93,
"YearRangeLow": 94.34,
"YearRangeHigh": 146.92,
"Volume": 17718787,
"AverageVolume": 7562403,
"MarketCap": 304189997056.0,
"Beta": 0.41,
"PriceEarningsRatio": 23.34,
"EarningsPerShare": 5.29,
"EarningsDate": "2021-04-20T00:00:00",
"ForwardDividend": 3.16,
"ForwardDividendYield": 0.0256,
"ExDividendDate": "2021-01-21T00:00:00",
"YearTargetEstimate": 150.56,
"QueriedSymbol": "PG",
"DataCollectedOn": "2021-02-28T23:33:18.8109488+00:00"
},
"Statistics": {
"FiscalYearEnds": "2020-06-29T00:00:00",
"MostRecentQuarter": "2020-12-30T00:00:00",
"ProfitMargin": 0.1872,
"OperatingMargin": 0.24129999,
"ReturnOnAssets": 0.0962,
"ReturnOnEquity": 0.2951,
"Revenue": 73969999872,
"RevenuePerShare": 29.83,
"QuarterlyRevenueGrowth": 0.083000004,
"GrossProfit": 36309999616,
"EBITDA": 20800000000,
"NetIncomeAvailableToCommon": 13580000256,
"DilutedEps": 5.29,
"QuarterlyEarningsGrowth": 0.037,
"TotalCash": 11939999744,
"TotalCashPerShare": 4.85,
"TotalDebt": 31100000256,
"TotalDebtEquityRatio": 64.07,
"CurrentRatio": 0.78,
"BookValuePerShare": 19.21,
"OperatingCashFlow": 19030001664,
"LeveredFreeCashFlow": 13899999232,
"Beta": 0.41,
"YearChange": 0.0332,
"SP500YearChange": 0.2392,
"YearHigh": 146.92,
"YearLow": 94.34,
"MovingAverage50Day": 130.11,
"MovingAverage200Day": 136.83,
"AverageVolume3Month": 7560000,
"AverageVolume10Day": 9300000,
"SharesOutstanding": 2460000000,
"Float": 2460000000,
"PercentHeldByInsiders": 0.0011,
"PercentHeldByInstitutions": 0.66110003,
"SharesShort": 14840000,
"ShortRatio": 1.95,
"ShortPercentOfFloat": 0.0061000003,
"ShortPercentOfSharesOutstanding": 0.006,
"ForwardAnnualDividend": 3.16,
"ForwardAnnualDividendYield": 0.0256,
"TrailingAnnualDividend": 3.12,
"TrailingAnnualDividendYield": 0.024600001,
"FiveYearAverageDividendYield": 2.9,
"DividendPayoutRatio": 0.5894,
"DividendDate": "2021-02-15T00:00:00",
"ExDividendDate": "2021-01-20T00:00:00",
"LastSplitFactor": "2:1",
"LastSplitDate": "2004-06-20T00:00:00",
"QueriedSymbol": "PG",
"DataCollectedOn": "2021-02-28T23:33:19.287638+00:00"
}
}

Crypto

Use these endpoints to access real-time data about cryptocurrencies.

Crypto Quote

Access pricing and trading activity data for virtually any cryptocurrency. All quotes are in U.S. Dollars.

GET
https://api.aletheiaapi.com/Crypto

Parameters

Required
symbol - the trading symbol of the cryptocurrency. For example, "BTC" for Bitcoin.

Example Requests

https://api.aletheiaapi.com/Crypto?symbol=BTC
https://api.aletheiaapi.com/Crypto?symbol=DOGE
https://api.aletheiaapi.com/Crypto?symbol=XRP
+ Example Response
{
"Symbol": "BTC",
"Name": "Bitcoin",
"Price": 39799.31,
"DollarChange": 1357.82,
"PercentChange": 0.0353,
"DayLow": 39350.46,
"DayHigh": 39831.87,
"YearLow": 9916.49,
"YearHigh": 64863.1,
"MarketCap": 747286036480.0,
"Volume": 25329145856,
"DataCollected": "2021-08-05T01:20:47.2696749+00:00"
}

Insider Trading

Read and monitor insider transactions for any publicly traded company.

Insider Trading (Webhook)

You can subscribe your application or web service to be notified of new insider trading the moment it is reported to the SEC. You can even specify the companies, individuals, security types, or transactions you only wish to be notified of.

Step 1 - Subscribe Your Endpoint

First you must subscribe your endpoint to the insider trading webhook service. You can subscribe your endpoint by making a POST call to the URL specified below.

POST
https://api.aletheiaapi.com/SubscribeToInsiderTradingWebhook
The following is an example of the body of the POST call you will make:
{
"endpoint":"https://www.myservice.net/myendpoint",
"issuer": "MSFT",
"owner": 1513142,
"transactionType": 1,
"securityType": 0
}
  • The endpoint property is mandatory! This is where you will specify the endpoint of your API service that Aletheia will call.
  • The issuer property specifies the company you only want to receive insider trading notifications for. Microsoft is the specified company (CIK 789019) in this example. You can either provide the trading symbol of the company ("MSFT" in this example) or the CIK of the company. Provide the CIK for faster performance. This property is optional.
  • The owner property is the CIK of the person you only want to receive insider trading notifications on. In this example we have it set to 1513142 which is the CIK of Satya Nadella, the CEO of Microsoft This property is optional.
  • The transactionType property specifies the the transaction type you only want to be notified of. Please see the transaction type property from the Latest Transactions endpoint to see the list of transaction type ID's. This property is optional.
  • The securityType property specifies the security type that you only want to be notified on. This means that you will only be notified of transactions involving either non-derivative (equity) securities or derivative securities. 0 = non-derivative, 1 = derivative. This property is optional.

For any optional property that you do not specify in the POST body, the assumption will be made that you would like to subscribe your endpoint to all of the available selections. For example, if I did not specify the issuer property when subscribing my endpoint, this will in turn mean that my endpoint will be called for transactions involving any company.

The subscription endpoint will return a 201 created response. This response will include a "Location" header. The value of this header will be used to unsubscribe from this webhook, so save this for later.

Step 2 - Receive New Filings!

After subscribing your endpoint to the webhook with step 1, your endpoint will begin to receive HTTP POST requests when new qualifying insider trades become available.

The following is an example of the POST request that will be sent to your registered endpoint:

POST
(your registered endpoint)
{
"SecEntities":[
{
"Cik":789019,
"Name":"MICROSOFT CORP",
"TradingSymbol":"MSFT"
},
{
"Cik":1186249,
"Name":"WARRIOR PADMASREE",
"TradingSymbol":null
}
],
"SecFilings":[
{
"Id":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"FilingUrl":"https://www.sec.gov/Archives/edgar/data/789019/000106299321005588/0001062993-21-005588-index.htm",
"AccessionP1":1062993,
"AccessionP2":21,
"AccessionP3":5588,
"FilingType":0,
"ReportedOn":"2021-06-10T00:00:00",
"Issuer":789019,
"_Issuer":null,
"Owner":1186249,
"_Owner":null
}
],
"HeldOfficerPositions":[],
"SecurityTransactionHoldings":[
{
"Id":"a5d49aae-a72f-49b3-afdd-7672ee7f8481",
"FromFiling":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"_FromFiling":null,
"EntryType":1,
"QuantityOwnedFollowingTransaction":11880.0,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":null,
"Quantity":null,
"PricePerSecurity":null,
"TransactionDate":null,
"TransactionCode":null,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
{
"Id":"ab2c09c9-e0b1-41f4-88f6-43992c966029",
"FromFiling":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"_FromFiling":null,
"EntryType":0,
"QuantityOwnedFollowingTransaction":3715.0,
"DirectIndirect":0,
"SecurityTitle":"Restricted Stock Units",
"SecurityType":1,
"AcquiredDisposed":0,
"Quantity":8.0,
"PricePerSecurity":0.0,
"TransactionDate":"2021-06-10T00:00:00",
"TransactionCode":null,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":"Common Stock",
"UnderlyingSecurityQuantity":8.0
}
]
}

You can find thorough explanations for each component of each component above in other endpoint documentation.

Step 3 - Unsubscribe from the webhook when finished

When you wish to stop receiving posts from this webhook, be sure to formally unsubscribe your endpoint.

When you originally registered your endpoint in step 1, the returned 201 created response contained a "Location" header. The value of this header contains the endpoint that will unsubscribe your endpoint via a DELETE call. The unsubscribe endpoint will look something like this:

https://api.aletheiaapi.com/UnsubscribeWebhook?id=dd150c44-c42a-4cdd-92f5-b78a23b36c72

To unsubscribe your endpoint from this webhook, call this provided value via a DELETE call.

If you no longer have the provided unsubscribe URL (ID of your webhook to unsubscribe with) from the original subscription step, you can also unsubscribe by providing your registered endpoint URL. For example, see below:

DELETE
https://api.aletheiaapi.com/UnsubscribeWebhook?endpoint=https://www.myservice.net/myendpoint

Search Entities

Search the Aletheia database for an entity. An entity represents either a company (serving as an security issuer) or a person (serving as a security owner).

GET
https://api.aletheiaapi.com/SearchEntities

Parameters

Required
term - The search term
Optional
top - Limit the number of results returned. Fewer results will return faster.

Example Requests

https://api.aletheiaapi.com/SearchEntities?term=intc
https://api.aletheiaapi.com/SearchEntities?term=amazon
https://api.aletheiaapi.com/SearchEntities?term=cook&top=3
+ Example Response
[
{
"Cik":1168017, - The SEC assigned Central Index Key (CIK) of this person
"Name":"COOK J MICHAEL"
},
{
"Cik":1227246,
"Name":"COOK IAN M"
},
{
"Cik":1270438,
"Name":"COOK LINDA Z"
}
]

Get Entity

Get details of a company or insider from their Central Index Key (CIK), a unique ID assigned by the Securities Exchange Commission.

GET
https://api.aletheiaapi.com/GetEntity

Parameters

Required
id - Either the CIK or the trading symbol of the entity you are requesting. Provide the CIK for faster performance.

Example Requests

https://api.aletheiaapi.com/GetEntity?id=66740
https://api.aletheiaapi.com/GetEntity?id=mmm
https://api.aletheiaapi.com/GetEntity?id=msft
+ Example Response
{
"Cik":66740, - The SEC-assigned Central Index Key (CIK) of this company/person
"Name":"3M CO", - Company/person name
"TradingSymbol":"MMM" - If the entity is a company, the trading symbol. If a person, this will be null.
}

Get Filing

Get details of a particular SEC filing that has already been processed by our servers.

! Please note that this endpoint will not access any filing with the SEC, but rather only queries filings that have already been scanned and processed and thus exist in our database.

GET
https://api.aletheiaapi.com/GetFiling

Parameters

Optional
id - The Aletheia-assigned unique ID of the filing. Note that this ID does not correspond to an SEC filing, but is rather an ID that we assigned to the filing in our database.
Optional
url - If you instead want to find details of the filing via the filing URL, specify the full filing URL.

! While the above parameters are optional, you must specify at least one.

Example Requests

https://api.aletheiaapi.com/GetFiling?id=70ebab7c-af6e-47e2-963a-0000b688ca7e
https://api.aletheiaapi.com/GetFiling?id=123c236790fe4328b85800013a5f7491
https://api.aletheiaapi.com/GetFiling?url=https://www.sec.gov/Archives/edgar/data/885725/000122520815006628/0001225208-15-006628-index.htm
+ Example Response
{
"Id":"70ebab7c-af6e-47e2-963a-0000b688ca7e", - The unique ID of this filing in the Aletheia database
"FilingUrl":"https://www.sec.gov/Archives/edgar/data/885725/000122520815006628/0001225208-15-006628-index.htm", - URL to the filing with the SEC
"AccessionP1":1225208, - Part 1 of the accession number (SEC's ID for this filing)
"AccessionP2":15, - Part 2 of the accession number (SEC's ID for this filing)
"AccessionP3":6628, - Part 3 of the accession number (SEC's ID for this filing)
"FilingType":0, - 0 = Form 4, 1 = Form 3, 2 = Form 5, 3 = 10-K, 4 = 10-Q
"ReportedOn":"2015-02-27T00:00:00", - the date this filing was reported on
"Issuer":885725, - The CIK (SEC-assigned ID) of the issuing company
"Owner":1533022, - This field will only populate if applicable (it is a form 3, 4, or 5 and thus has an associated insider making the trade)
}

Latest Transactions

Download the latest insider transactions for a person or company.

GET
https://api.aletheiaapi.com/LatestTransactions

Parameters

Optional
issuer - Either the CIK or trading symbol of the securities issuer (company).
Optional
owner - The CIK of the owner (insider trader).

! The parameters 'issuer' and 'owner' are both optional, but you must provide at least one.

Optional
top - How many records you would like returned. Default is 20.
Optional
before - Filter to transactions only before a particular date.
  • Date supplied in format YYYYMMDD. For example, "20191231".
Optional
securitytype - Filter security type. 0 = non-derivative (equity), 1 = derivative.
Optional
transactiontype - Filter to a particular transaction type.
  • 0 = purchase
  • 1 = sale
  • 2 = transaction voluntarily reported earlier than required
  • 3 = grant or award
  • 4 = sale back to issuer
  • 5 = payment of exercise price or tax liability
  • 6 = discretionary transaction
  • 7 = exercise or conversion of derivative security
  • 8 = conversion of derivative security
  • 9 = expiration of short derivative position
  • 10 = expiration of long derivative position
  • 11 = exercise of out-of-the-money derivative
  • 12 = exercise of in-the-money derivative
  • 13 = bona fide gift
  • 14 = small acquisition
  • 15 = acquisition or disposition by will or laws
  • 16 = deposit into or withdrawal from voting trust
  • 17 = other acquisition or disposition
  • 18 = equity swap
  • 19 = disposition due to tender of shares
Optional
cascade - If you would also like data about the SEC filing the transaction came from and both of issuer and owner, specify this label in the URl. Only specify '&cascade' in the URL, no need to provide a value.

! Due to the larger quantity quantity of data being accessed, cascade querying may be noticeably slower.

Example Requests

https://api.aletheiaapi.com/LatestTransactions?issuer=1800&top=5
https://api.aletheiaapi.com/LatestTransactions?issuer=1800&owner=1783147&before=20181231&securitytype=0&transactiontype=3
https://api.aletheiaapi.com/LatestTransactions?owner=1783147&securitytype=1&transactiontype=0
+ Example Response
[
{
"Id":"e3fd7062-5190-43a5-9aa0-26ce8ce2ddea", - The unique ID of this transaction in the Aletheia database
"FromFiling":"c42b0232-45d3-48e6-8f27-b97621947d3b", - The unique ID of the SEC filing in the Aletheia database which this transaction stemmed from
"EntryType":0, - 0 = Transaction, 1 = Holding (no changes, just reporting a held asset)
"QuantityOwnedFollowingTransaction":0.0, - The quantity of securities the owner owns following this transaction
"DirectIndirect":1, - 0 = Direct ownership, 1 = Indirect ownership
"SecurityTitle":"Common Stock",
"SecurityType":0, - 0 = non-derivative (equity based), 1 = derivative (i.e. options contract)
"AcquiredDisposed":1, - 0 = acquired, 1 = disposed
"Quantity":50.0, - The quantity of securities acquired/disposed of
"PricePerSecurity":null, - if applicable, the average acquisition or disposition price of the security
"TransactionDate":"2021-02-17T00:00:00", - recorded transaction date
"TransactionCode":1, - (see the "transactiontype" parameter above)
"ConversionOrExercisePrice":null, - if a derivative security, the exercise price of this contract
"ExercisableDate":null, - if a derivative security, the exercisable date of this contract
"ExpirationDate":null, - if a derivative security, the expiration date of this contract
"UnderlyingSecurityTitle":null, - if a derivative security, the title of the contract's underlying security
"UnderlyingSecurityQuantity":null - if a derivative security, the quantity of the contract's underlying security
},
{
"Id":"bf6b3afc-2591-48e6-8dda-0b62903fd38d",
"FromFiling":"01bf4617-5f19-4319-b378-c16a9d12190a",
"EntryType":0,
"QuantityOwnedFollowingTransaction":1508.4543,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":0,
"Quantity":289.0,
"PricePerSecurity":null,
"TransactionDate":"2021-02-05T00:00:00",
"TransactionCode":7,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
{
"Id":"d24bc278-dbc6-4d7f-a144-69bdcd81ad38",
"FromFiling":"d5ba901e-5002-413c-9358-b3445b66ccae",
"EntryType":0,
"QuantityOwnedFollowingTransaction":252.47,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":0,
"Quantity":252.47,
"PricePerSecurity":null,
"TransactionDate":"2021-02-05T00:00:00",
"TransactionCode":3,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
]

Affiliated Owners

List the insiders who at some point in the time held or made transactions with a particular company.

GET
https://api.aletheiaapi.com/AffiliatedOwners

Parameters

Required
id - Either the CIK or the trading symbol of the company you are requesting. Provide the CIK for faster performance.

Example Requests

https://api.aletheiaapi.com/AffiliatedOwners?id=789019
https://api.aletheiaapi.com/AffiliatedOwners?id=msft
https://api.aletheiaapi.com/AffiliatedOwners?id=aapl
+ Example Response
[
{
"Cik":1007844, - The SEC-assigned Central Index Key (unique ID) of this person
"Name":"JOBS STEVEN P" - The person's name
},
{
"Cik":1051401,
"Name":"JUNG ANDREA"
},
{
"Cik":1059235,
"Name":"WAGNER SUSAN"
},
{
"Cik":1179864,
"Name":"LOZANO MONICA C"
},
{
"Cik":1182047,
"Name":"BELL JAMES A"
},
{
"Cik":1188888,
"Name":"CAMPBELL WILLIAM V"
},
{
"Cik":1196612,
"Name":"AHRENDTS ANGELA J"
},
{
"Cik":1198726,
"Name":"YORK JEROME B"
}
]

Fundamentals

These endpoints provide with you financial performance data for any publicly traded company. These endpoints span all three primary financial statements, including Income Statement, Balance Sheet, and State of Cash Flows.

Common Financials

Access a financial statement set for a particular company. The returned response will be a financial fact set that is presented in a commonly comparable form.

GET
https://api.aletheiaapi.com/CommonFinancials

Parameters

Required
id - The CIK or trading symbol of the company you are searching for.
Optional
period - Specify a period type.
  • 0 = Annual (from a 10-K filing)
  • 1 = Quarterly (from a 10-Q filing)
Optional
before - Get the most recent filing before this specified date. YYYYMMDD format.
  • If this parameter is not specified, the API will simply select the most recent financial filing that meets your criteria.

Example Requests

https://api.aletheiaapi.com/CommonFinancials?id=aapl
https://api.aletheiaapi.com/CommonFinancials?id=320193&period=1
https://api.aletheiaapi.com/CommonFinancials?id=320193&period=0&before=20150101
Example Response
+ Example Response
{
"PeriodStart": "2013-09-29T00:00:00",
"PeriodEnd": "2014-09-27T00:00:00",
"Facts": {
"RetainedEarnings": 87152000000.0,
"OperatingIncome": 52503000000.0,
"Revenue": 182795000000.0,
"SellingGeneralAndAdministrativeExpense": 11993000000.0,
"ResearchAndDevelopmentExpense": 6041000000.0,
"Assets": 231839000000.0,
"NetIncome": 39510000000.0,
"ProceedsFromIssuanceOfDebt": 11960001000.0,
"OperatingCashFlows": 59713000000.0,
"CurrentLiabilities": 63448000000.0,
"Equity": 111547000000.0,
"DividendsPaid": 11031000000.0,
"Liabilities": 120292000000.0,
"CommonStockSharesOutstanding": 5866161000.0,
"CurrentAssets": 68531000000.0,
"InvestingCashFlows": -22579000000.0,
"FinancingCashFlows": -37549000000.0,
"Cash": 13844000000.0
}
}

Financial Fact Trend

Examine the trend in a financial result data point for any major commonly-reported figure on an income statement, balance sheet, or statement of cash flows.

GET
https://api.aletheiaapi.com/FinancialFactTrend

Parameters

Required
id - The CIK or trading symbol of the company you are searching for.
Required
label - The label name of the data point you are requesting. Available data points:
  • Income Statement Facts
    • 0 = Revenue
    • 1 = Selling, General, and Administrative Expenses (SG&A)
    • 2 = Research and Development Expenses
    • 3 = Operating Income
    • 4 = Net Income/Loss
  • Balance Sheet Facts
    • 5 = Assets
    • 6 = Liabilities
    • 7 = Equity
    • 8 = Cash
    • 9 = Current Assets
    • 10 = Current Liabilities
    • 11 = Retained Earnings/Deficit
    • 12 = Number of common stock shares outstanding
  • Cash Flow Statement Facts
    • 13 = Operating Cash Flows
    • 14 = Investing Cash Flows
    • 15 = Financing Cash Flows
    • 16 = Proceeds from Issuance of Debt
    • 17 = Payments of Debt
    • 18 = Dividends Paid
Optional
period - Specify a period type.
  • 0 = Annual (from a 10-K filing)
  • 1 = Quarterly (from a 10-Q filing)
Optional
after - Only return data points after a specific date. YYYYMMDD format.
Optional
before - Only return data points before a specific date. YYYYMMDD format.

Example Requests

https://api.aletheiaapi.com/FinancialFactTrend?id=msft&label=0&period=0
https://api.aletheiaapi.com/FinancialFactTrend?id=msft&label=8&after=20140101
https://api.aletheiaapi.com/FinancialFactTrend?id=1800&label=4&before=20150101
Example Response
+ Example Response
[
{
"PeriodStart": "2012-07-01T00:00:00", - The start date for the period this fact occured in
"PeriodEnd": "2013-06-30T00:00:00", - The end date for the period this fact occured in
"Value": 77849000000.0 - the fact value
},
{
"PeriodStart": "2015-07-01T00:00:00",
"PeriodEnd": "2016-06-30T00:00:00",
"Value": 85320000000.0
},
{
"PeriodStart": "2009-07-01T00:00:00",
"PeriodEnd": "2010-06-30T00:00:00",
"Value": 62484000000.0
},
{
"PeriodStart": "2011-07-01T00:00:00",
"PeriodEnd": "2012-06-30T00:00:00",
"Value": 73723000000.0
},
{
"PeriodStart": "2019-07-01T00:00:00",
"PeriodEnd": "2020-06-30T00:00:00",
"Value": 143015000000.0
},
{
"PeriodStart": "2013-07-01T00:00:00",
"PeriodEnd": "2014-06-30T00:00:00",
"Value": 86833000000.0
},
{
"PeriodStart": "2016-07-01T00:00:00",
"PeriodEnd": "2017-06-30T00:00:00",
"Value": 89950000000.0
},
{
"PeriodStart": "2017-07-01T00:00:00",
"PeriodEnd": "2018-06-30T00:00:00",
"Value": 110360000000.0
},
{
"PeriodStart": "2014-07-01T00:00:00",
"PeriodEnd": "2015-06-30T00:00:00",
"Value": 93580000000.0
},
{
"PeriodStart": "2018-07-01T00:00:00",
"PeriodEnd": "2019-06-30T00:00:00",
"Value": 125843000000.0
},
{
"PeriodStart": "2010-07-01T00:00:00",
"PeriodEnd": "2011-06-30T00:00:00",
"Value": 69943000000.0
}
]

Earnings Calls

Aletheia continuously processes new earnings calls for many publicly traded companies on a daily basis. You can use these endpoints for accessing earnings call content and highlights from the call.

Search Earnings Calls

Search our database for available earnings call transcripts and highlights.

GET
https://api.aletheiaapi.com/SearchEarningsCalls

Parameters

Optional
company - The trading symbol of the of the company.
Optional
year - The fiscal year of the earnings call you are requesting.
Optional
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'.
Optional
top - The maximum number of records to return. Max is 50, default is 15.

Example Requests

https://api.aletheiaapi.com/SearchEarningsCalls?company=fb&year=2020
https://api.aletheiaapi.com/SearchEarningsCalls?year=2020&quarter=q3&top=8
https://api.aletheiaapi.com/SearchEarningsCalls?company=msft&year=2021
Example Response
+ Example Response
[
{
"Id": "31a7e56c-d6bb-4224-81f6-a0c3400d690b", - the unique ID of this earnings call
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f", - the unique ID of the company
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 2, - Fiscal quarter. 0 = Q1, 1 = Q2, 2 = Q3, 3 = Q4
"Year": 2021, - the fiscal year
"HeldAt": "2021-04-27T00:00:00" - date the call was held on
},
{
"Id": "2cb52ca5-b8a2-4219-8cb3-7de95f40c75f",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 1,
"Year": 2021,
"HeldAt": "2021-01-26T00:00:00"
},
{
"Id": "3da4547a-afbe-47c0-95c8-856b71692ca2",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 0,
"Year": 2021,
"HeldAt": "2020-10-27T00:00:00"
},
{
"Id": "e2ee094f-e34f-48e8-ae02-332057ca6798",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 3,
"Year": 2020,
"HeldAt": "2020-07-22T00:00:00"
},
{
"Id": "d3dbcc49-b774-4055-840b-51e7853d7a84",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 2,
"Year": 2020,
"HeldAt": "2020-04-29T00:00:00"
},
{
"Id": "c1d2bba5-d502-44d5-b16d-a9bfb77cfafd",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 1,
"Year": 2020,
"HeldAt": "2020-01-29T00:00:00"
},
{
"Id": "c3a97166-8881-4b4c-bf5d-21b0e24e2f56",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 0,
"Year": 2020,
"HeldAt": "2019-10-23T00:00:00"
},
{
"Id": "9950dcc5-a3f8-4787-b4a2-fccf1afdd69b",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 3,
"Year": 2019,
"HeldAt": "2019-07-18T00:00:00"
}
]

Earnings Call

Access contextual information and spoken content for a publicly traded company's earnings call.

GET
https://api.aletheiaapi.com/EarningsCall

Parameters

Required
company - The trading symbol of the of the company.
Required
year - The fiscal year of the earnings call you are requesting.
Required
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'.
Optional
begin - The earnings call is arranged into a series of remarks in order of sequence spoken. With the begin and end parameter, you can select a series of remarks from the call to be returned.
Optional
end - The sequence number for the final spoken remark which you are requesting. Please note that the maximum number of remarks that can be requested in one call is 20.

Example Requests

https://api.aletheiaapi.com/EarningsCall?company=DLTR&year=2019&quarter=q4&begin=0&end=10
https://api.aletheiaapi.com/EarningsCall?company=DLTR&year=2019&quarter=q4&begin=11&end=20
https://api.aletheiaapi.com/EarningsCall?company=AAPL&year=2020&quarter=q1
Example Response
+ Example Response
{
"Id": "d78ef856-bd63-4a7a-928b-0015d770d9be",
"Year": 2019,
"Period": 3,
"Company": {
"Id": "b80ad0f3-ecbe-4f18-b33b-3951cc049d3a",
"Name": "Dollar Tree Inc",
"TradingSymbol": "DLTR"
},
"Remarks": [
{
"SequenceNumber": 0,
"Remark": "Good day, and welcome to the Dollar Tree Incorporated Fourth Quarter Earnings Conference Call. Today's conference is being recorded. At this time, I would like to turn the conference over to Mr. Randy Guiler, Vice President, Investor Relations. Please go ahead, sir.",
"SpokenBy": {
"Id": "bc18a561-7a1e-427e-be39-c2644eda4a11",
"Name": "Operator",
"Title": "Operator",
"IsExternal": false
}
},
{
"SequenceNumber": 1,
"Remark": "Thank you, Britney. Good morning, and welcome to our call to discuss Dollar Tree's performance for the fourth fiscal quarter and fiscal year 2019. On today's call will be CEO, Gary Philbin; Enterprise President, Mike Witynski; and CFO, Kevin Wampler.",
"SpokenBy": {
"Id": "8d2f9fec-edf0-494c-b21b-7b11f28ea557",
"Name": "Randy Guiler",
"Title": "Vice President, Investor Relations",
"IsExternal": false
}
},
{
"SequenceNumber": 2,
"Remark": "Before we begin, I would like to remind everyone that various remarks that we will make about future expectations, plans and prospects for the Company constitute forward-looking statements for the purposes of the Safe Harbor provisions under the Private Securities Litigation Reform Act of 1995. Actual results may differ materially from those indicated by these forward-looking statements as a result of various important factors included in our most recent press release, most recent 8-K, 10-Q and Annual Report, which are on file with the SEC. We have no obligation to update our forward-looking statements and you should not expect us to do so.",
"SpokenBy": {
"Id": "8d2f9fec-edf0-494c-b21b-7b11f28ea557",
"Name": "Randy Guiler",
"Title": "Vice President, Investor Relations",
"IsExternal": false
}
},
{
"SequenceNumber": 3,
"Remark": "In the fourth quarter, the Company incurred several discrete charges as described below: a $313 million non-cash charge for goodwill impairment, a $24.6 million reduction in tax expense for the reversal of a valuation allowance related to the Company's foreign net operating loss carry-forwards, an $18 million charge to the litigation reserve, and a $0.3 million acceleration in non-cash deferred financing cost associated with a debt prepayment. These items are detailed in the reconciliation of non-GAAP financial measures in today's press release. Unless otherwise noted, all margin, net income, and earnings comparisons presented today exclude the impact of these discrete charges from the fourth quarter and fiscal year.",
"SpokenBy": {
"Id": "8d2f9fec-edf0-494c-b21b-7b11f28ea557",
"Name": "Randy Guiler",
"Title": "Vice President, Investor Relations",
"IsExternal": false
}
},
{
"SequenceNumber": 4,
"Remark": "At the end of our prepared remarks, we will open the call to your questions. Please limit your questions to one and one follow-up if necessary.",
"SpokenBy": {
"Id": "8d2f9fec-edf0-494c-b21b-7b11f28ea557",
"Name": "Randy Guiler",
"Title": "Vice President, Investor Relations",
"IsExternal": false
}
},
{
"SequenceNumber": 5,
"Remark": "Now, I will turn the call over to Gary Philbin, Dollar Tree's Chief Executive Officer.",
"SpokenBy": {
"Id": "8d2f9fec-edf0-494c-b21b-7b11f28ea557",
"Name": "Randy Guiler",
"Title": "Vice President, Investor Relations",
"IsExternal": false
}
},
{
"SequenceNumber": 6,
"Remark": "Thank you, Randy. Good morning, everyone. I'm proud of our team's accomplishments in fiscal 2019, including the successful consolidation of our store support centers, the material acceleration of the Family Dollar store optimization program and the initial launch of our Dollar TreePlus! initiative. For Q4, despite the compressed holiday shopping season with six fewer days between Thanksgiving, Christmas, we delivered positive same-store sales for the enterprise, while managing margins and costs effectively to deliver adjusted EPS of $1.79, near the top end of our guidance range.",
"SpokenBy": {
"Id": "6a13165c-0cc1-4fd6-a378-fac7a05a4649",
"Name": "Gary M. Philbin",
"Title": "Chief Executive Officer",
"IsExternal": false
}
},
{
"SequenceNumber": 7,
"Remark": "Fiscal 2019 was an important year for our organization, as we further developed the foundation and fundamentals to grow and improve our business. Accomplishments for 2019 include the following: first, consolidation of our store support center brought the Family Dollar and Dollar Tree teams together in one building. This was a major project and announced in September of 2018 and completed this past July. Our working in one space has increased the energy, benefited our culture and driven collaboration, efficiency and teamwork that will enable us to provide even better support to our stores as we move through 2020.",
"SpokenBy": {
"Id": "6a13165c-0cc1-4fd6-a378-fac7a05a4649",
"Name": "Gary M. Philbin",
"Title": "Chief Executive Officer",
"IsExternal": false
}
},
{
"SequenceNumber": 8,
"Remark": "Our store support consolidation allowed us to organize our management around the key processes within the company and flattened our organization to accomplish the speed and focus we need to have on key initiatives this year. We made significant progress on the Family Dollar store optimization program, including closing more than 400 stores, rebannering 200 Family Dollar stores to Dollar Trees and renovating more than 1,100 mature stores at Family Dollar into the H2 format.",
"SpokenBy": {
"Id": "6a13165c-0cc1-4fd6-a378-fac7a05a4649",
"Name": "Gary M. Philbin",
"Title": "Chief Executive Officer",
"IsExternal": false
}
},
{
"SequenceNumber": 9,
"Remark": "Third, the Dollar TreePlus! was introduced around mid-year. Mike will provide an update on the initiative, including the details of our Dollar TreePlus! 2.0 that's being implemented into our test stores this month. Fourth, we repurchased $200 million in shares during 2019. In recent years, we have made significant process [Phonetic] in paying down debt. We have a scheduled debt payment for $250 million in April 2020, and we currently have an $800 million authorization remaining on our Board repurchase plan.",
"SpokenBy": {
"Id": "6a13165c-0cc1-4fd6-a378-fac7a05a4649",
"Name": "Gary M. Philbin",
"Title": "Chief Executive Officer",
"IsExternal": false
}
},
{
"SequenceNumber": 10,
"Remark": "Our merchant teams traveled overseas for their annual post-holiday buying trip in January. This trip was led by our Enterprise Chief Merchant. The teams continue to work directly with a diverse group of qualified factories. In fact, we had vendors from eight other Asian countries attend our qualifying Open Buying Day. We consider this to be one of our most successful buying trips. We were pleased with the continued support we are receiving from our extended vendor group, and we're able to buy the value in key items and departments for both banners for the 2020 holiday season. Importantly, all returned from China healthy and safe just prior to the news regarding the outbreak of the coronavirus.",
"SpokenBy": {
"Id": "6a13165c-0cc1-4fd6-a378-fac7a05a4649",
"Name": "Gary M. Philbin",
"Title": "Chief Executive Officer",
"IsExternal": false
}
}
]
}

Earnings Call Highlights

Aletheia analyzes each earnings call and extracts the meaningful words, phrases, and financial figures from the calls. You can use the Earnings Call Highlights endpoint to directly request the most important remarks from the call. You can even filter this further and request the most important remarks involving a particular financial category (i.e. important remarks related to revenue, earnings per share, guidance, financial figures, etc).

GET
https://api.aletheiaapi.com/EarningsCallHighlights

Parameters

Required
company - The trading symbol of the of the company.
Required
year - The fiscal year of the earnings call you are requesting.
Required
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'.
Optional
category - This parameter provides you the ability to request the highlights for a particular financial category. For example, by using this parameter you can request the highlight remarks that mention earnings per share.
  • 0 - Revenue
  • 1 - Earnings
  • 2 - Cash Flow
  • 3 - Other
  • 4 - Growth
  • 5 - Financial Figure
  • 6 - Volume
  • 7 - Guidance
  • 8 - Management Perception of the Situation
Optional
top - The number of highlights to return in the response. Default (if not specified) is 5, maxiumum is 12.

Example Requests

https://api.aletheiaapi.com/EarningsCallHighlights?company=DLTR&year=2019&quarter=q4
https://api.aletheiaapi.com/EarningsCallHighlights?company=DLTR&year=2019&quarter=q4&category=0
https://api.aletheiaapi.com/EarningsCallHighlights?company=AAPL&year=2020&quarter=q1&category=5&top=3
Example Response
+ Example Response
[
{
"Id": "423a379d-a22c-4340-b8f5-40abe350a301",
"Remark": "For the first quarter, we are forecasting total sales to range from $5.89 billion to $5.99 billion and diluted earnings per share in the range of $1.00 to $1.09. These estimates are based on a low-single digit increase in same-store sales and year-over-year square footage growth of 1.5%. For fiscal 2020, we are forecasting total sales to range between $24.21 billion and $24.66 billion based on a low-single digit same-store sales increase and approximately 3.1% selling square footage growth. The Company anticipates GAAP net income per diluted share for fiscal 2020 will range between $4.80 and $5.15.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [ The response will include the start position and end position of each keyword or phrase that was recognized being of interest
{
"BeginPosition": 85,
"EndPosition": 89,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 146,
"EndPosition": 150,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 460,
"EndPosition": 463,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 283,
"EndPosition": 286,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 373,
"EndPosition": 378,
"Category": 5,
"Rating": 4.0
}
]
},
{
"Id": "f5d98c26-e11c-4855-b655-38045f25350e",
"Remark": "And looking at our 2020 outlook when compared to 2019 performance, the upper end of our 2020 guidance is $5.15. Adding back the impact of $47 million or $0.15 per share in incremental tariffs in 2020 and $28.6 million or $0.12 per share for the equalization of tax rates for both years brings the adjusted EPS for 2020 at the high-end to $5.42. When compared to the 2019 adjusted earnings per share of $4.76, 2020 adjusted earnings of $5.42 would be a 14% increase year-over-year.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [
{
"BeginPosition": 93,
"EndPosition": 100,
"Category": 7,
"Rating": 6.0
},
{
"BeginPosition": 204,
"EndPosition": 208,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 338,
"EndPosition": 338,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 452,
"EndPosition": 454,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 105,
"EndPosition": 105,
"Category": 5,
"Rating": 4.0
}
]
},
{
"Id": "957bb7b1-dec2-4136-abfa-1e3e2beaf582",
"Remark": "For the fourth quarter on a GAAP basis, the Company had net income of $123 million or $0.52 per diluted share. This compared to a GAAP net loss of $2.3 billion or a loss of $9.69 per share in the prior year's quarter. On an adjusted basis, diluted earnings per share for Q4 2019 were $1.79. Please refer to the reconciliation of non-GAAP financial measures in today's press release.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [
{
"BeginPosition": 135,
"EndPosition": 142,
"Category": 1,
"Rating": 5.0
},
{
"BeginPosition": 86,
"EndPosition": 90,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 284,
"EndPosition": 284,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 147,
"EndPosition": 150,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 248,
"EndPosition": 265,
"Category": 1,
"Rating": 4.0
}
]
}
]

SEC Filings

Access and monitor filings with the Securities Exchange Commission's EDGAR database.

New SEC Filings (Webhook)

You can subscribe your application or web service to be notified of new SEC filings with this webhook.

Step 1 - Subscribe Your Endpoint

First you must subscribe your endpoint to the new filings webhook service.

POST
https://api.aletheiaapi.com/SubscribeToNewFilingsWebhook
The body must contain the URL endpoint of your API service. The body must be in JSON format with your endpoint stored in the "endpoint" property. Example:
{"endpoint": "https://www.myservice.net/myendpoint"}
The subscription endpoint will return a 201 created response. This response will include a "Location" header. The value of this header will be used to unsubscribe from this webhook, so save this for later.

Step 2 - Receive New Filings!

After subscribing your endpoint to the webhook with step 1, your endpoint will begin to receive HTTP POST requests when a new SEC filing is available.

The following is an example of the POST request that will be sent to your registered endpoint:

POST
(your registered endpoint)
{
    "EntityTitle":"BlackRock Capital Investment Corp",
    "EntityCik":1326003,
    "Filing":"4",
    "DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/1326003/000120919121008361/0001209191-21-008361-index.htm",
    "Description":"Statement of changes in beneficial ownership of securities Accession Number: 0001209191-21-008361 Size: 9 KB\n",
    "FilingDate":"2021-02-05T00:00:00"
}

Step 3 - Unsubscribe from the webhook when finished

When you wish to stop receiving posts from this webhook, be sure to formally unsubscribe your endpoint.

When you originally registered your endpoint in step 1, the returned 201 created response contained a "Location" header. The value of this header contains the endpoint that will unsubscribe your endpoint via a DELETE call. The unsubscribe endpoint will look something like this:

https://api.aletheiaapi.com/UnsubscribeFromNewFilingsWebhookById?id=dd150c44-c42a-4cdd-92f5-b78a23b36c72

To unsubscribe your endpoint from this webhook, call this provided value via a DELETE call.

If you no longer have the provided unsubscribe URL from the original subscription step, you can also unsubscribe by providing your registered endpoint to the 'UnsubscribeFromNewFilingsWebhookByEndpoint' api. For example, see below:

DELETE
https://api.aletheiaapi.com/UnsubscribeFromNewFilingsWebhookByEndpoint?endpoint=https://www.myservice.net/myendpoint

Entity Filings

Query the latest SEC filings for a particular company or person.

GET
https://api.aletheiaapi.com/EntityFilings

Parameters

Required
id - The CIK or trading symbol of the company or person you are searching for
Optional
filing - Filing type filter. For example, 10-K or 10-Q
Optional
before - Filter to filings only before a particular date, in YYYYMMDD format

Example Requests

https://api.aletheiaapi.com/EntityFilings?id=msft&filing=10-k
https://api.aletheiaapi.com/EntityFilings?id=0000050863&before=20180101
https://api.aletheiaapi.com/EntityFilings?id=pg&filing=4&before=20160701
+ Example Response
[
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-20-034944&xbrl_type=v", - Quick view of extracted data
"Filing":"10-K", - filing type
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459020034944/0001564590-20-034944-index.htm", - URL to filing
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-20-034944 (34 Act)  Size: 27 MB", - filing description
"FilingDate":"2020-07-30T00:00:00" - Date the SEC received the filing
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-19-027952&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459019027952/0001564590-19-027952-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-19-027952 (34 Act)  Size: 26 MB",
"FilingDate":"2019-08-01T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-18-019062&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459018019062/0001564590-18-019062-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-18-019062 (34 Act)  Size: 29 MB",
"FilingDate":"2018-08-03T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-17-014900&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459017014900/0001564590-17-014900-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-17-014900 (34 Act)  Size: 28 MB",
"FilingDate":"2017-08-02T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001193125-16-662209&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000119312516662209/0001193125-16-662209-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001193125-16-662209 (34 Act)  Size: 13 MB",
"FilingDate":"2016-07-28T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001193125-15-272806&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000119312515272806/0001193125-15-272806-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001193125-15-272806 (34 Act)  Size: 14 MB",
"FilingDate":"2015-07-31T00:00:00"
}
]

Open Form 4

Open a statement of change in beneficial ownership (form 4) to reveal details of insider trading

GET
https://api.aletheiaapi.com/OpenForm4

Parameters

Required
filingurl - the URL of the form 4 filing with the SEC
  • Tip: Use the filing url of a form 4 filing that was returned via the "EntityFilings" endpoint (see above)

Example Requests

https://api.aletheiaapi.com/OpenForm4?filingurl=https://www.sec.gov/Archives/edgar/data/50863/000112760221003952/0001127602-21-003952-index.htm
https://api.aletheiaapi.com/OpenForm4?filingurl=https://www.sec.gov/Archives/edgar/data/1318605/000179056521000001/0001790565-21-000001-index.htm
+ Example Response
{
"SchemaVersion":"X0306", - Schema of the XBRL used in this report
"PeriodOfReport":"2021-02-02T00:00:00",
"IssuerCik":"0000050863", - The Central Index Key (ID) of the issuing company
"IssuerName":"INTEL CORP", - Issuing company name
"IssuerTradingSymbol":"INTC", - Issuing company trading symbol
"OwnerName":"McBride Kevin Thomas", - Name of the insider making the trade
"OwnerCik":"0001723374", - The Central Index Key (ID) of the insider making the trade
"OwnerStreet1":"C/O INTEL CORPORATION",
"OwnerStreet2":"2200 MISSION COLLEGE BLVD",
"OwnerCity":"SANTA CLARA",
"OwnerStateCode":"CA",
"OwnerZipCode":"95054",
"OwnerIsOfficer":true,
"OwnerOfficerTitle":"VP Finance, Corp. Controller",
"NonDerivativeTransactions":[ - Equity (non-derivative) trades
{
"SecurityTitle":"Common Stock",
"SecuritiesOwnedFollowingTransaction":14214.0,
"DirectOrIndirectOwnership":0,
"TransactionDate":"2021-02-02T00:00:00",
"TransactionCode":1,
"TransactionQuantity":589.0,
"TransactionPricePerSecurity":57.17,
"AcquiredOrDisposed":1
}
],
"DerivativeTransactions":null - Derivative trades (similar format to above)
}

Open Common Financials

Open a financial report document (10-K or 10-Q) filing to a financial statement.

GET
https://api.aletheiaapi.com/OpenCommonFinancials

Parameters

Required
filingurl - the URL of the 10-K or 10-Q with the SEC. Note: This must be a 10-K or 10-Q.
  • Tip: Use the filing url of a 10-K/10-Q filing that was returned via the "EntityFilings" endpoint (see above)

Example Requests

https://api.aletheiaapi.com/OpenCommonFinancials?filingurl=https://www.sec.gov/Archives/edgar/data/789019/000156459020034944/0001564590-20-034944-index.htm
https://api.aletheiaapi.com/OpenCommonFinancials?filingurl=https://www.sec.gov/Archives/edgar/data/1326801/000132680120000084/0001326801-20-000084-index.htm
+ Example Response
{
"PeriodStart":"2019-07-01T00:00:00",
"PeriodEnd":"2020-06-30T00:00:00",
"Revenue":1.43015E+11,
"SellingGeneralAndAdministrativeExpense":null,
"ResearchAndDevelopmentExpense":1.9269E+10,
"OperatingIncome":5.2959E+10,
"NetIncome":4.4281E+10,
"Assets":3.01311E+11,
"Liabilities":1.83007E+11,
"Equity":1.18304E+11,
"Cash":1.3575999E+10,
"CurrentAssets":1.81915E+11,
"CurrentLiabilities":7.231E+10,
"RetainedEarnings":3.4566E+10,
"CommonStockSharesOutstanding":7570999808,
"OperatingCashFlows":6.0675E+10,
"InvestingCashFlows":-1.2223E+10,
"FinancingCashFlows":-4.6031E+10,
"ProceedsFromIssuanceOfDebt":0.0,
"PaymentsOfDebt":5.518E+09,
"DividendsPaid":1.5137E+10
}

Usage Metrics

You can use these endpoints to monitor your consumtion of the Aletheia API service.

Consumption

Count the number of API calls you have made or have been made to you (via webhook) for any time window or for a particular month.

GET
https://api.aletheiaapi.com/consumption

Parameters

Optional
begin - If requesting consumption during a window, the beginning date of the window you are requesting.
Optional
end - If requesting consumption during a window, the ending date of the window you are requesting.
Optional
year - If requesting consumption for a particular month, the year that contains the month you are requesting.
Optional
month - If requesting consumption for a particular month, the month you are requesting (1-12).

Example Requests

https://api.aletheiaapi.com/consumption?begin=20210101&end=20210501
https://api.aletheiaapi.com/consumption?begin=20210401&end=20210501
https://api.aletheiaapi.com/consumption?year=2021&month=5
Example Response
+ Example Response
4837

My Calls

Retrieve history of the most recent calls you have made.

GET
https://api.aletheiaapi.com/mycalls

Parameters

Optional
last - The number of transactions to retrieve. Minimum: 1, Maximum: 100

Example Requests

https://api.aletheiaapi.com/mycalls?last=5
https://api.aletheiaapi.com/mycalls?last=75
Example Response
+ Example Response
[
{
"Endpoint": "Financials", - the title of the endpoint you called
"CalledAtUtc": "2021-05-21T23:22:28", - the date and time you made the API call
"Direction": "Request" - If you called the service, "Request". If a webhook called your endpoint, "Push"
},
{
"Endpoint": "EntityFilings",
"CalledAtUtc": "2021-05-21T23:22:21",
"Direction": "Request"
},
{
"Endpoint": "Consumption",
"CalledAtUtc": "2021-05-21T23:11:47",
"Direction": "Request"
},
{
"Endpoint": "OpenForm4",
"CalledAtUtc": "2021-05-21T23:11:37",
"Direction": "Request"
},
{
"Endpoint": "OpenCommonFinancials",
"CalledAtUtc": "2021-05-21T23:03:54",
"Direction": "Request"
}
]

Service Information

These endpoints provide contextual information about the Aletheia service.

API Version

Get the actively deployed version of the Aletheia API service

GET
https://api.aletheiaapi.com/version

Count Entities

Count the number of SEC entities that have been processed and collected.

GET
https://api.aletheiaapi.com/CountSecEntities

Parameters

Optional
onlyco - Short for "only companies". Specify 'true' to count only entities that have a trading symbol and thus are security-issuing companies. Only valid values are 'true' and 'false'. Default is 'false'.

Count Filings

Count the number of SEC filings that have been processed and collected.

GET
https://api.aletheiaapi.com/CountSecFilings

Count Transactions

Count the number of transactions that have been processed and collected from from 3, 4, and 5's from the SEC.

GET
https://api.aletheiaapi.com/CountTransactions

Count Fact Contexts

Count the number of Fact Contexts that are available for consumption from the Fundamentals service category.

GET
https://api.aletheiaapi.com/CountFactContexts

Count Financial Facts

Count the number of financial data points that have been collected and are available for consumption from the Fundamentals service category. You can count the number of data points in overall or narrow down to data points belonging to a specific company.

GET
https://api.aletheiaapi.com/CountFinancialFacts

Parameters

Optional
id - Provide the CIK or trading symbol if you would like to only count the number of datapoints that exist for a particular company.

Example Requests

https://api.aletheiaapi.com/CountFinancialFacts
https://api.aletheiaapi.com/CountFinancialFacts?id=MSFT
https://api.aletheiaapi.com/CountFinancialFacts?id=789019