Retrieve List of Institutions
Returns a list of institutions.
get/api/institutions
Query parameters
limitinteger
Example:10
How many items to return. Default 500. Max 500. Min 1.
max_share_valuestring
Example:10.0
The maximum share value for the query.
max_total_valuestring
Example:10.0
The maximum total value for the query.
min_share_valuestring
Example:0.5
The minimum share value for the query.
min_total_valuestring
Example:0.5
The minimum total value for the query.
namestring
Example:VANGUARD GROUP INC
A large entity that manages funds and investments for others. Queryable by name or CIK.
order'name' | 'call_value' | 'put_value' | 'share_value' | 'call_holdings' | 'put_holdings' | 'share_holdings' | 'total_value' | 'warrant_value' | 'fund_value' | 'pfd_value' | 'debt_value' | 'total_holdings' | 'warrant_holdings' | 'fund_holdings' | 'pfd_holdings' | 'debt_holdings' | 'percent_of_total' | 'date' | 'buy_value' | 'sell_value'
Example:name
Optional columns to order the result by.
order_direction'desc' | 'asc'
Example:asc
Whether to sort descending or ascending. Default is descending.
pageinteger
Example:1
Page number (use with limit). Starts on page 0.
tagsstring[]
An array of institution tags.
[ "activist" ]
Response
Successful response with a list of institutions.
Example response
{
"data": [
{
"buy_value": "2394292.0",
"call_holdings": "2394292.0",
"call_value": "2394292.0",
"cik": "0000102909",
"date": "2024-10-02",
"debt_holdings": "2394292.0",
"debt_value": "2394292.0",
"filing_date": "2024-10-01",
"fund_holdings": "2394292.0",
"fund_value": "2394292.0",
"is_hedge_fund": true,
"name": "VANGUARD GROUP INC",
"people": [
"Paul Singer"
],
"pfd_holdings": "2394292.0",
"pfd_value": "2394292.0",
"put_holdings": "2394292.0",
"put_value": "2394292.0",
"sell_value": "2394292.0",
"share_value": "2394292.0",
"short_name": "Vanguard",
"tags": [
"activist",
"value_investor"
],
"total_value": "2394292.0",
"warrant_holdings": "2394292.0",
"warrant_value": "2394292.0"
}
]
}