Outstanding Shares & Public Float Data API
The API provides the number of outstanding shares for each class of securities and the public float for publicly traded companies listed on US stock markets. It includes both the most recent outstanding shares and float as well as historical information. Historical data is often used for backtesting trading strategies or for modelling company valuations. If a company has multiple share classes, the API returns the outstanding share count for each class. The database is searchable by ticker or CIK of a company.
Example: Outstanding Shares & Public Float Data Response
1
{
2
"tickers": ["GOOGL", "GOOG"],
3
"cik": "1652044",
4
"reportedAt": "2023-02-02T21:23:45-05:00",
5
"periodOfReport": "2022-12-31",
6
"float": {
7
"outstandingShares": [
8
{
9
"period": "2023-01-26",
10
"shareClass": "CommonClassA",
11
"value": 5956000000
12
},
13
{
14
"period": "2023-01-26",
15
"shareClass": "CommonClassB",
16
"value": 883000000
17
},
18
{
19
"period": "2023-01-26",
20
"shareClass": "CapitalClassC",
21
"value": 5968000000
22
}
23
],
24
"publicFloat": [
25
{
26
"period": "2022-06-30",
27
"shareClass": "",
28
"value": 1256100000000
29
}
30
]
31
},
32
"sourceFilingAccessionNo": "0001652044-23-000016",
33
"id": "4a29432e1345e30a01e4aa10a2b57b62"
34
}
The share count per class, public float and reference period is derived from the latest quarterly and annual reports, including data from both domestic and foreign EDGAR filers.
The data excludes any shares issued or bought back after the latest quarterly or annual report.
Dataset size:
Outstanding shares and public float of all listed and unlisted companies on US stock markets.
Data update frequency:
New data is available within 300 milliseconds after a new filing is published.
Data history:
From 2011 to present.
Survivorship bias free:
Yes. The database includes all outstanding shares and public float data of companies listed and unlisted on US stock markets.
API Endpoint
To search and retrieve current and historical outstanding shares and float data, send an HTTP GET request with the ticker or CIK of a company to the following API endpoint:
https://api.sec-api.io/float
Supported HTTP methods: GET
Response content type: JSON
Authentication
To authenticate your API requests, use the API key available in your user profile. You can utilize your API key in one of two ways. Choose the method that best fits your implementation:
- Authorization Header: Include your API key as an
Authorizationheader in yourGETrequests. For instance, before sending aGETrequest tohttps://api.sec-api.io/float, ensure the header is set as follows:Authorization: YOUR_API_KEY. - Query Parameter: Alternatively, append your API key directly to the URL as a query parameter. For example, when making
GETrequests, use the URLhttps://api.sec-api.io/float?token=YOUR_API_KEYinstead of the base endpoint.
Request Parameters
Outstanding shares and float data can be retrieved by providing either the ticker or CIK of a company as a query parameter to the API endpoint. The following parameters are supported:
ticker(string) - The ticker of the company. Example:AAPLcik(string) - The CIK of the company. Remove leading zeros. Example:1067983(valid),0001067983(invalid)
Request Examples
GEThttps://api.sec-api.io/float?ticker=AAPLGEThttps://api.sec-api.io/float?cik=1318605
Response Structure
Response type: JSON
data(array) - Array of float data items.id(string) - Unique ID of float data item. Example:f7611b5b0ddb134ae6d4701043eb0e9dtickers(array of strings) - Tickers the float data applies to. Includes a single ticker if one share class is available. Includes multiples tickers if multiple share classes are available. Examples:["AMD"],["GOOG", "GOOGL"],["CAT", "CAT23", "CAT35"]cik(string) - CIK of the filer, without trailing zeros. Example:18230reportedAt(datetime) - The datetime the filing and float data was published. Example:2023-02-15T10:27:56-05:00periodOfReport(date) - The period of the report the float data applies to. Example:2022-12-31float(object) - Float data for the reporting period.outstandingShares(array) - Array of outstanding shares objects. Each object includes the number of outstanding shares per share class and the period the information applies to.period(date) - Period the information applies to. Example:2022-12-31shareClass(string) - Share class (if reported). Example:CommonClassA,CapitalClassCvalue(integer) - Number of outstanding shares per share class. Example:1372751831
publicFloat(array) - Array of public float objects (if any). Each object includes the disclosed dollar amount of the public float and the period the information applies to.period(date) - Period the information applies to. Example:2022-12-31shareClass(string) - Share class (if reported). Example:CommonClassA,CapitalClassCvalue(integer) - Public float in US dollar. Example:367009000000
sourceFilingAccessionNo(string) - The accession number of the filing the float data was reported in. Example:0000018230-23-000011
total(object) - Query statisticvalue(integer) - The number of float data items matching your query.
Response Examples
Request: GET https://api.sec-api.io/float?ticker=GOOG
Response:
JSON
1
{
2
"data": [
3
{
4
"tickers": ["GOOGL", "GOOG"],
5
"cik": "1652044",
6
"reportedAt": "2023-02-02T21:23:45-05:00",
7
"periodOfReport": "2022-12-31",
8
"float": {
9
"outstandingShares": [
10
{
11
"period": "2023-01-26",
12
"shareClass": "CommonClassA",
13
"value": 5956000000
14
},
15
{
16
"period": "2023-01-26",
17
"shareClass": "CommonClassB",
18
"value": 883000000
19
},
20
{
21
"period": "2023-01-26",
22
"shareClass": "CapitalClassC",
23
"value": 5968000000
24
}
25
],
26
"publicFloat": [
27
{
28
"period": "2022-06-30",
29
"shareClass": "",
30
"value": 1256100000000
31
}
32
]
33
},
34
"sourceFilingAccessionNo": "0001652044-23-000016",
35
"id": "4a29432e1345e30a01e4aa10a2b57b62"
36
},
37
{
38
"id": "f027daeb28740f5c0e21686ea16285b8",
39
"tickers": [
40
"GOOGL",
41
"GOOG"
42
],
43
"cik": "1652044",
44
"float": {
45
"outstandingShares": [
46
{
47
"period": "2022-10-18",
48
"shareClass": "CommonClassA",
49
"value": 5973000000
50
},
51
{
52
"period": "2022-10-18",
53
"shareClass": "CommonClassB",
54
"value": 884000000
55
},
56
{
57
"period": "2022-10-18",
58
"shareClass": "CapitalClassC",
59
"value": 6086000000
60
}
61
],
62
"publicFloat": []
63
},
64
"reportedAt": "2022-10-25T21:32:59-04:00",
65
"periodOfReport": "2022-09-30",
66
"sourceFilingAccessionNo": "0001652044-22-000090"
67
},
68
{
69
"id": "a269f5d0b63b69a2e6a820cb7ad7c85d",
70
"tickers": [
71
"GOOGL",
72
"GOOG"
73
],
74
"cik": "1652044",
75
"float": {
76
"outstandingShares": [
77
{
78
"period": "2022-07-22",
79
"shareClass": "CommonClassA",
80
"value": 5996000000
81
},
82
{
83
"period": "2022-07-22",
84
"shareClass": "CommonClassB",
85
"value": 885000000
86
},
87
{
88
"period": "2022-07-22",
89
"shareClass": "CapitalClassC",
90
"value": 6163000000
91
}
92
],
93
"publicFloat": []
94
},
95
"reportedAt": "2022-07-26T19:29:36-04:00",
96
"periodOfReport": "2022-06-30",
97
"sourceFilingAccessionNo": "0001652044-22-000071"
98
}
99
... more results
100
],
101
"total": { "value": 33, "relation": "eq" }
102
}
Request: GET https://api.sec-api.io/float?cik=18230
Response:
JSON
1
{
2
"data": [
3
{
4
"id": "6a472c6d18dd0234877282fef2aa574b",
5
"tickers": [
6
"CAT",
7
"CAT23",
8
"CAT35"
9
],
10
"cik": "18230",
11
"float": {
12
"outstandingShares": [
13
{
14
"period": "2022-12-31",
15
"shareClass": "",
16
"value": 516345490
17
}
18
],
19
"publicFloat": [
20
{
21
"period": "2022-06-30",
22
"shareClass": "",
23
"value": 94700000000
24
}
25
]
26
},
27
"reportedAt": "2023-02-15T10:27:56-05:00",
28
"periodOfReport": "2022-12-31",
29
"sourceFilingAccessionNo": "0000018230-23-000011"
30
},
31
{
32
"id": "0ca9ccf7834eda89f3efc2c25331716b",
33
"tickers": [
34
"CAT",
35
"CAT23",
36
"CAT35"
37
],
38
"cik": "18230",
39
"float": {
40
"outstandingShares": [
41
{
42
"period": "2022-09-30",
43
"shareClass": "",
44
"value": 520409355
45
}
46
],
47
"publicFloat": []
48
},
49
"reportedAt": "2022-11-02T10:37:08-04:00",
50
"periodOfReport": "2022-09-30",
51
"sourceFilingAccessionNo": "0000018230-22-000223"
52
}
53
... more results
54
],
55
"total": { "value": 47, "relation": "eq" }
56
}