SEC EDGAR Form 13F-NT, 13F-NT/A GraphQL Documentation

This documentation includes the GraphQL query and subscription specification for access to the Securities and Exchange Commission (SEC EDGAR ) data on our platform.

Contact

Beam API Support

support@beamapi.com

https://beamapi.freshdesk.com

Terms of Service

https://beamapi.com/terms

API Endpoints
# Production Server for Queries:
https://api.beamapi.com/data/fundamentals/us/sec/form_13fnt/v1/
# Production Server for Subscriptions:
wss://api.beamapi.com/data/fundamentals/us/sec/form_13fnt/v1/ws
Headers
# Your API key from the dashboard. Must be included in all API calls. For websocket connections, this value is put in an initial on connection payload.
{"api-key": "<YOUR_TOKEN_HERE>"}
Version

1

Queries

cover_page

Response

Returns [Form13FNTCoverPage!]!

Arguments
Name Description
offset - Int
filters - FilterForm13FNTCoverPage

Example

Query
query cover_page(
  $offset: Int,
  $filters: FilterForm13FNTCoverPage
) {
  cover_page(
    offset: $offset,
    filters: $filters
  ) {
    additional_information
    amendment_number
    amendment_type
    entity_cik
    filing_accession_number
    filing_manager_address_city
    filing_manager_address_state_or_country
    filing_manager_address_street_1
    filing_manager_address_street_2
    filing_manager_address_zip_code
    filing_manager_name
    form_13f_file_number
    is_amendment
    provide_info_for_instruction_5
    report_calender_or_quarter
    report_type
  }
}
Variables
{"offset": 123, "filters": FilterForm13FNTCoverPage}
Response
{
  "data": {
    "cover_page": [
      {
        "additional_information": "xyz789",
        "amendment_number": 987,
        "amendment_type": "abc123",
        "entity_cik": 987,
        "filing_accession_number": 123,
        "filing_manager_address_city": "xyz789",
        "filing_manager_address_state_or_country": "abc123",
        "filing_manager_address_street_1": "xyz789",
        "filing_manager_address_street_2": "abc123",
        "filing_manager_address_zip_code": "abc123",
        "filing_manager_name": "abc123",
        "form_13f_file_number": 987,
        "is_amendment": true,
        "provide_info_for_instruction_5": "abc123",
        "report_calender_or_quarter": "abc123",
        "report_type": "xyz789"
      }
    ]
  }
}
Queries

cover_page_count

Response

Returns an Int!

Arguments
Name Description
filters - FilterForm13FNTCoverPage

Example

Query
query cover_page_count($filters: FilterForm13FNTCoverPage) {
  cover_page_count(filters: $filters)
}
Variables
{"filters": FilterForm13FNTCoverPage}
Response
{"data": {"cover_page_count": 987}}
Queries

header_data

Response

Returns [Form13FNTHeaderData!]!

Arguments
Name Description
offset - Int
filters - FilterForm13FNTHeaderData

Example

Query
query header_data(
  $offset: Int,
  $filters: FilterForm13FNTHeaderData
) {
  header_data(
    offset: $offset,
    filters: $filters
  ) {
    ccc
    cik
    confirming_copy_flag
    contact_email
    contact_name
    contact_phone
    entity_cik
    file_number
    filing_accession_number
    live_test_flag
    notification_email_addresses
    override_internet_flag
    period_of_report
    return_copy_flag
    submission_type
  }
}
Variables
{"offset": 123, "filters": FilterForm13FNTHeaderData}
Response
{
  "data": {
    "header_data": [
      {
        "ccc": "xyz789",
        "cik": 123,
        "confirming_copy_flag": false,
        "contact_email": "abc123",
        "contact_name": "abc123",
        "contact_phone": "abc123",
        "entity_cik": 987,
        "file_number": 987,
        "filing_accession_number": 123,
        "live_test_flag": "xyz789",
        "notification_email_addresses": [
          "abc123"
        ],
        "override_internet_flag": true,
        "period_of_report": "abc123",
        "return_copy_flag": false,
        "submission_type": "abc123"
      }
    ]
  }
}
Queries

header_data_count

Response

Returns an Int!

Arguments
Name Description
filters - FilterForm13FNTHeaderData

Example

Query
query header_data_count($filters: FilterForm13FNTHeaderData) {
  header_data_count(filters: $filters)
}
Variables
{"filters": FilterForm13FNTHeaderData}
Response
{"data": {"header_data_count": 123}}
Queries

other_manager_reporting_for_this_manager

Response

Returns [Form13FNTOtherManagerReportingForThisManager!]!

Arguments
Name Description
offset - Int
filters - FilterForm13FNTOtherManagerReportingForThisManager

Example

Query
query other_manager_reporting_for_this_manager(
  $offset: Int,
  $filters: FilterForm13FNTOtherManagerReportingForThisManager
) {
  other_manager_reporting_for_this_manager(
    offset: $offset,
    filters: $filters
  ) {
    cik
    crd_number
    entity_cik
    filing_accession_number
    form_13f_file_number
    name
    pos
    sec_file_number
  }
}
Variables
{
  "offset": 987,
  "filters": FilterForm13FNTOtherManagerReportingForThisManager
}
Response
{
  "data": {
    "other_manager_reporting_for_this_manager": [
      {
        "cik": 987,
        "crd_number": "xyz789",
        "entity_cik": 987,
        "filing_accession_number": 987,
        "form_13f_file_number": 987,
        "name": "xyz789",
        "pos": 123,
        "sec_file_number": "xyz789"
      }
    ]
  }
}
Queries

other_manager_reporting_for_this_manager_count

Response

Returns an Int!

Arguments
Name Description
filters - FilterForm13FNTOtherManagerReportingForThisManager

Example

Query
query other_manager_reporting_for_this_manager_count($filters: FilterForm13FNTOtherManagerReportingForThisManager) {
  other_manager_reporting_for_this_manager_count(filters: $filters)
}
Variables
{
  "filters": FilterForm13FNTOtherManagerReportingForThisManager
}
Response
{"data": {"other_manager_reporting_for_this_manager_count": 123}}
Queries

signature

Response

Returns [Form13FNTSignature!]!

Arguments
Name Description
offset - Int
filters - FilterForm13FNTSignature

Example

Query
query signature(
  $offset: Int,
  $filters: FilterForm13FNTSignature
) {
  signature(
    offset: $offset,
    filters: $filters
  ) {
    city
    entity_cik
    filing_accession_number
    name
    phone
    signature
    state_or_country
    title
  }
}
Variables
{"offset": 123, "filters": FilterForm13FNTSignature}
Response
{
  "data": {
    "signature": [
      {
        "city": "abc123",
        "entity_cik": 987,
        "filing_accession_number": 123,
        "name": "xyz789",
        "phone": "xyz789",
        "signature": "abc123",
        "state_or_country": "xyz789",
        "title": "abc123"
      }
    ]
  }
}
Queries

signature_count

Response

Returns an Int!

Arguments
Name Description
filters - FilterForm13FNTSignature

Example

Query
query signature_count($filters: FilterForm13FNTSignature) {
  signature_count(filters: $filters)
}
Variables
{"filters": FilterForm13FNTSignature}
Response
{"data": {"signature_count": 987}}

Subscriptions

cover_page

Response

Returns an Form13FNTCoverPage!

Arguments
Name Description
filters - FilterForm13FNTCoverPage

Example

Query
subscription cover_page($filters: FilterForm13FNTCoverPage) {
  cover_page(filters: $filters) {
    additional_information
    amendment_number
    amendment_type
    entity_cik
    filing_accession_number
    filing_manager_address_city
    filing_manager_address_state_or_country
    filing_manager_address_street_1
    filing_manager_address_street_2
    filing_manager_address_zip_code
    filing_manager_name
    form_13f_file_number
    is_amendment
    provide_info_for_instruction_5
    report_calender_or_quarter
    report_type
  }
}
Variables
{"filters": FilterForm13FNTCoverPage}
Response
{
  "data": {
    "cover_page": {
      "additional_information": "xyz789",
      "amendment_number": 987,
      "amendment_type": "xyz789",
      "entity_cik": 123,
      "filing_accession_number": 123,
      "filing_manager_address_city": "abc123",
      "filing_manager_address_state_or_country": "abc123",
      "filing_manager_address_street_1": "abc123",
      "filing_manager_address_street_2": "abc123",
      "filing_manager_address_zip_code": "xyz789",
      "filing_manager_name": "abc123",
      "form_13f_file_number": 987,
      "is_amendment": false,
      "provide_info_for_instruction_5": "abc123",
      "report_calender_or_quarter": "abc123",
      "report_type": "abc123"
    }
  }
}
Subscriptions

header_data

Response

Returns an Form13FNTHeaderData!

Arguments
Name Description
filters - FilterForm13FNTHeaderData

Example

Query
subscription header_data($filters: FilterForm13FNTHeaderData) {
  header_data(filters: $filters) {
    ccc
    cik
    confirming_copy_flag
    contact_email
    contact_name
    contact_phone
    entity_cik
    file_number
    filing_accession_number
    live_test_flag
    notification_email_addresses
    override_internet_flag
    period_of_report
    return_copy_flag
    submission_type
  }
}
Variables
{"filters": FilterForm13FNTHeaderData}
Response
{
  "data": {
    "header_data": {
      "ccc": "abc123",
      "cik": 987,
      "confirming_copy_flag": true,
      "contact_email": "xyz789",
      "contact_name": "abc123",
      "contact_phone": "abc123",
      "entity_cik": 987,
      "file_number": 123,
      "filing_accession_number": 123,
      "live_test_flag": "abc123",
      "notification_email_addresses": [
        "xyz789"
      ],
      "override_internet_flag": false,
      "period_of_report": "abc123",
      "return_copy_flag": false,
      "submission_type": "abc123"
    }
  }
}
Subscriptions

other_manager_reporting_for_this_manager

Response

Returns an Form13FNTOtherManagerReportingForThisManager!

Arguments
Name Description
filters - FilterForm13FNTOtherManagerReportingForThisManager

Example

Query
subscription other_manager_reporting_for_this_manager($filters: FilterForm13FNTOtherManagerReportingForThisManager) {
  other_manager_reporting_for_this_manager(filters: $filters) {
    cik
    crd_number
    entity_cik
    filing_accession_number
    form_13f_file_number
    name
    pos
    sec_file_number
  }
}
Variables
{
  "filters": FilterForm13FNTOtherManagerReportingForThisManager
}
Response
{
  "data": {
    "other_manager_reporting_for_this_manager": {
      "cik": 987,
      "crd_number": "abc123",
      "entity_cik": 123,
      "filing_accession_number": 987,
      "form_13f_file_number": 123,
      "name": "xyz789",
      "pos": 987,
      "sec_file_number": "xyz789"
    }
  }
}
Subscriptions

signature

Response

Returns an Form13FNTSignature!

Arguments
Name Description
filters - FilterForm13FNTSignature

Example

Query
subscription signature($filters: FilterForm13FNTSignature) {
  signature(filters: $filters) {
    city
    entity_cik
    filing_accession_number
    name
    phone
    signature
    state_or_country
    title
  }
}
Variables
{"filters": FilterForm13FNTSignature}
Response
{
  "data": {
    "signature": {
      "city": "abc123",
      "entity_cik": 987,
      "filing_accession_number": 987,
      "name": "abc123",
      "phone": "xyz789",
      "signature": "abc123",
      "state_or_country": "xyz789",
      "title": "xyz789"
    }
  }
}

Types

Boolean

Description

The Boolean scalar type represents true or false.

Example
true
Types

FilterForm13FNTCoverPage

Fields
Input Field Description
additional_information - String
amendment_number - FilterableI64
amendment_type - String
entity_cik - FilterableI64
filing_accession_number - FilterableI64
filing_manager_address_city - String
filing_manager_address_state_or_country - String
filing_manager_address_street_1 - String
filing_manager_address_street_2 - String
filing_manager_address_zip_code - String
filing_manager_name - String
form_13f_file_number - FilterableI64
is_amendment - Boolean
provide_info_for_instruction_5 - String
report_calender_or_quarter - String
report_type - String
Example
{
  "additional_information": "abc123",
  "amendment_number": FilterableI64,
  "amendment_type": "abc123",
  "entity_cik": FilterableI64,
  "filing_accession_number": FilterableI64,
  "filing_manager_address_city": "abc123",
  "filing_manager_address_state_or_country": "xyz789",
  "filing_manager_address_street_1": "xyz789",
  "filing_manager_address_street_2": "abc123",
  "filing_manager_address_zip_code": "xyz789",
  "filing_manager_name": "xyz789",
  "form_13f_file_number": FilterableI64,
  "is_amendment": true,
  "provide_info_for_instruction_5": "xyz789",
  "report_calender_or_quarter": "abc123",
  "report_type": "abc123"
}
Types

FilterForm13FNTHeaderData

Fields
Input Field Description
ccc - String
cik - FilterableI64
confirming_copy_flag - Boolean
contact_email - String
contact_name - String
contact_phone - String
entity_cik - FilterableI64
file_number - FilterableI64
filing_accession_number - FilterableI64
live_test_flag - String
notification_email_addresses - [String!]
override_internet_flag - Boolean
period_of_report - String
return_copy_flag - Boolean
submission_type - String
Example
{
  "ccc": "xyz789",
  "cik": FilterableI64,
  "confirming_copy_flag": true,
  "contact_email": "abc123",
  "contact_name": "abc123",
  "contact_phone": "abc123",
  "entity_cik": FilterableI64,
  "file_number": FilterableI64,
  "filing_accession_number": FilterableI64,
  "live_test_flag": "abc123",
  "notification_email_addresses": [
    "xyz789"
  ],
  "override_internet_flag": false,
  "period_of_report": "abc123",
  "return_copy_flag": true,
  "submission_type": "abc123"
}
Types

FilterForm13FNTOtherManagerReportingForThisManager

Fields
Input Field Description
cik - FilterableI64
crd_number - String
entity_cik - FilterableI64
filing_accession_number - FilterableI64
form_13f_file_number - FilterableI64
name - String
pos - FilterableI32
sec_file_number - String
Example
{
  "cik": FilterableI64,
  "crd_number": "abc123",
  "entity_cik": FilterableI64,
  "filing_accession_number": FilterableI64,
  "form_13f_file_number": FilterableI64,
  "name": "xyz789",
  "pos": FilterableI32,
  "sec_file_number": "abc123"
}
Types

FilterForm13FNTSignature

Fields
Input Field Description
city - String
entity_cik - FilterableI64
filing_accession_number - FilterableI64
name - String
phone - String
signature - String
state_or_country - String
title - String
Example
{
  "city": "abc123",
  "entity_cik": FilterableI64,
  "filing_accession_number": FilterableI64,
  "name": "xyz789",
  "phone": "abc123",
  "signature": "abc123",
  "state_or_country": "abc123",
  "title": "xyz789"
}
Types

FilterableI32

Fields
Input Field Description
equal - Int
range - I32Range
Example
{"equal": 987, "range": I32Range}
Types

FilterableI64

Fields
Input Field Description
equal - Int
range - I64Range
Example
{"equal": 123, "range": I64Range}
Types

Form13FNTCoverPage

Fields
Field Name Description
additional_information - String
amendment_number - Int
amendment_type - String
entity_cik - Int
filing_accession_number - Int
filing_manager_address_city - String
filing_manager_address_state_or_country - String
filing_manager_address_street_1 - String
filing_manager_address_street_2 - String
filing_manager_address_zip_code - String
filing_manager_name - String
form_13f_file_number - Int
is_amendment - Boolean
provide_info_for_instruction_5 - String
report_calender_or_quarter - String
report_type - String
Example
{
  "additional_information": "abc123",
  "amendment_number": 123,
  "amendment_type": "xyz789",
  "entity_cik": 987,
  "filing_accession_number": 987,
  "filing_manager_address_city": "xyz789",
  "filing_manager_address_state_or_country": "xyz789",
  "filing_manager_address_street_1": "abc123",
  "filing_manager_address_street_2": "xyz789",
  "filing_manager_address_zip_code": "abc123",
  "filing_manager_name": "xyz789",
  "form_13f_file_number": 987,
  "is_amendment": false,
  "provide_info_for_instruction_5": "xyz789",
  "report_calender_or_quarter": "xyz789",
  "report_type": "abc123"
}
Types

Form13FNTHeaderData

Fields
Field Name Description
ccc - String
cik - Int
confirming_copy_flag - Boolean
contact_email - String
contact_name - String
contact_phone - String
entity_cik - Int
file_number - Int
filing_accession_number - Int
live_test_flag - String
notification_email_addresses - [String!]
override_internet_flag - Boolean
period_of_report - String
return_copy_flag - Boolean
submission_type - String
Example
{
  "ccc": "xyz789",
  "cik": 987,
  "confirming_copy_flag": true,
  "contact_email": "abc123",
  "contact_name": "abc123",
  "contact_phone": "xyz789",
  "entity_cik": 123,
  "file_number": 123,
  "filing_accession_number": 123,
  "live_test_flag": "abc123",
  "notification_email_addresses": [
    "xyz789"
  ],
  "override_internet_flag": true,
  "period_of_report": "xyz789",
  "return_copy_flag": false,
  "submission_type": "xyz789"
}
Types

Form13FNTOtherManagerReportingForThisManager

Fields
Field Name Description
cik - Int
crd_number - String
entity_cik - Int
filing_accession_number - Int
form_13f_file_number - Int
name - String
pos - Int
sec_file_number - String
Example
{
  "cik": 123,
  "crd_number": "abc123",
  "entity_cik": 987,
  "filing_accession_number": 987,
  "form_13f_file_number": 123,
  "name": "abc123",
  "pos": 123,
  "sec_file_number": "xyz789"
}
Types

Form13FNTSignature

Fields
Field Name Description
city - String
entity_cik - Int
filing_accession_number - Int
name - String
phone - String
signature - String
state_or_country - String
title - String
Example
{
  "city": "xyz789",
  "entity_cik": 987,
  "filing_accession_number": 123,
  "name": "abc123",
  "phone": "xyz789",
  "signature": "abc123",
  "state_or_country": "abc123",
  "title": "xyz789"
}
Types

I32HighEnd

Fields
Input Field Description
le - Int
lt - Int
Example
{"le": 987, "lt": 987}
Types

I32LowEnd

Fields
Input Field Description
ge - Int
gt - Int
Example
{"ge": 987, "gt": 987}
Types

I32Range

Fields
Input Field Description
lowEnd - I32LowEnd
highEnd - I32HighEnd
Example
{
  "lowEnd": I32LowEnd,
  "highEnd": I32HighEnd
}
Types

I64HighEnd

Fields
Input Field Description
le - Int
lt - Int
Example
{"le": 123, "lt": 987}
Types

I64LowEnd

Fields
Input Field Description
ge - Int
gt - Int
Example
{"ge": 123, "gt": 987}
Types

I64Range

Fields
Input Field Description
lowEnd - I64LowEnd
highEnd - I64HighEnd
Example
{
  "lowEnd": I64LowEnd,
  "highEnd": I64HighEnd
}
Types

Int

Description

The Int scalar type represents non-fractional whole numeric values.

Example
123
Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"xyz789"
Documentation by Anvil SpectaQL