SEC form 13F API

Default

apiV1FilerGet

Retrieve a filer by CIK.

Returns a filer with the specified CIK (Central Index Key) and associated company names.


/api/v1/filer

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/filer?cik=1067983"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
cik = 1067983 # String | The Central Index Key (CIK) of the filer. (default to null)

try:
    # Retrieve a filer by CIK.
    api_response = api_instance.api_v1_filer_get(cik)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FilerGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
cik*
String
The Central Index Key (CIK) of the filer.
Required

Responses


apiV1FilersGet

Retrieve unique filers.

Returns a list of unique filers with their CIK and associated company names.


/api/v1/filers

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/filers?offset=0&limit=100"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
offset = 0 # Integer | Skip previous offset CIKs (optional) (default to 0)
limit = 100 # Integer | Return max limit CIKs (optional) (default to 100)

try:
    # Retrieve unique filers.
    api_response = api_instance.api_v1_filers_get(offset=offset, limit=limit)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FilersGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
offset
Integer
Skip previous offset CIKs
limit
Integer
Return max limit CIKs

Responses


apiV1FilingsGet

Retrieve 13F filings for all filers in the time range.

Get the 13F filings for all filers in the specified time range. Uses a form filing date as timestamp.


/api/v1/filings

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/filings?from=2023-01-01&to=2023-12-31&offset=0&limit=100"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
from = 2023-01-01 # date | All filings returned will be on or after this filing date. (default to null)
to = 2023-12-31 # date | All filings returned will be on or before this filing date. (default to null)
offset = 0 # Integer | Skip the first offset filings. (optional) (default to 0)
limit = 100 # Integer | Return at most limit filings. (optional) (default to 100)

try:
    # Retrieve 13F filings for all filers in the time range.
    api_response = api_instance.api_v1_filings_get(from, to, offset=offset, limit=limit)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FilingsGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
from*
date (date)
All filings returned will be on or after this filing date.
Required
to*
date (date)
All filings returned will be on or before this filing date.
Required
offset
Integer
Skip the first offset filings.
limit
Integer
Return at most limit filings.

Responses


apiV1FormGet

Get SEC Form 13F.

Retrieve a content of form 13F by accession number and CIK.


/api/v1/form

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/form?accession_number=0000950123-24-008740&cik=0001067983&offset=0&limit=100"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
accessionNumber = 0000950123-24-008740 # String | The accession number of the form entry. (default to null)
cik = 0001067983 # String | The Central Index Key (CIK) of the form entry. (default to null)
offset = 0 # Integer | The offset for pagination. (optional) (default to 0)
limit = 100 # Integer | The limit for pagination. (optional) (default to 100)

try:
    # Get SEC Form 13F.
    api_response = api_instance.api_v1_form_get(accessionNumber, cik, offset=offset, limit=limit)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FormGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
accession_number*
String
The accession number of the form entry.
Required
cik*
String
The Central Index Key (CIK) of the form entry.
Required
offset
Integer (int32)
The offset for pagination.
limit
Integer (int32)
The limit for pagination.

Responses


apiV1FormsGet

Retrieve SEC forms 13F for a filer.

This API returns SEC 13F forms between dates for a filer with CIK. Uses a period of report as timestamp.


/api/v1/forms

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/forms?cik=0001067983&from=2023-12-31&to=2024-12-31&offset=0&limit=100"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
cik = 0001067983 # String | The Central Index Key (CIK) of the filer. (default to null)
from = 2023-12-31 # String | All forms returned will be on or after this period of report date. (optional) (default to 2010-01-01)
to = 2024-12-31 # String | All forms returned will be on or before this period of report date. (optional) (default to 2030-01-01)
offset = 0 # Integer | Skip the first offset forms. (optional) (default to 0)
limit = 100 # Integer | Return at most limit forms. (optional) (default to 100)

try:
    # Retrieve SEC forms 13F for a filer.
    api_response = api_instance.api_v1_forms_get(cik, from=from, to=to, offset=offset, limit=limit)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FormsGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
cik*
String
The Central Index Key (CIK) of the filer.
Required
from
String
All forms returned will be on or after this period of report date.
to
String
All forms returned will be on or before this period of report date.
offset
Integer
Skip the first offset forms.
limit
Integer
Return at most limit forms.

Responses


apiV1FundsGet

Retrieve unique companies.

Returns a list of unique companies with their names and associated CIKs.


/api/v1/funds

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/funds?name=berkshire&offset=0&limit=100"
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
name = berkshire # String | Filter companies by by a substring of their name (optional) (default to null)
offset = 0 # Integer | Skip previous offset companies (optional) (default to 0)
limit = 100 # Integer | Return max limit companies (optional) (default to 100)

try:
    # Retrieve unique companies.
    api_response = api_instance.api_v1_funds_get(name=name, offset=offset, limit=limit)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1FundsGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
name
String
Filter companies by by a substring of their name
offset
Integer
Skip previous offset companies
limit
Integer
Return max limit companies

Responses


apiV1TickersGet

Returns cusip, ticker, and company name for provided matching cusips or tickers parameters

Either `cusips` or `tickers` parameter must be provided.


/api/v1/tickers

Usage and SDK Samples

curl -X GET \
 -H "Accept: application/json" \
 "https://forms13f.com/api/v1/tickers?cusips=037833100,594918104&tickers="
from __future__ import print_statement
import time
import forms13f
from forms13f.rest import ApiException
from pprint import pprint

# Create an instance of the API class
api_instance = forms13f.DefaultApi()
cusips = 037833100,594918104 # array[String] | Array of CUSIPs to match (optional) (default to null)
tickers =  # array[String] | Array of tickers to match (optional) (default to null)

try:
    # Returns cusip, ticker, and company name for provided matching cusips or tickers parameters
    api_response = api_instance.api_v1_tickers_get(cusips=cusips, tickers=tickers)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->apiV1TickersGet: %s\n" % e)

Scopes

Parameters

Query parameters
Name Description
cusips
array[String]
Array of CUSIPs to match
tickers
array[String]
Array of tickers to match

Responses