Form N-PX Proxy Voting Records API

The Form N-PX API consists of two APIs: the N-PX Search API and the Voting Record API. The N-PX Search API enables filtering all N-PX filings published on the SEC EDGAR database since 2024. The API accepts search queries as JSON formatted payload and returns the matching N-PX filings in JSON format. The Voting Record API allows downloading the proxy voting records in structured JSON format for a specific filing by providing the filing's accession number.

Form N-PX filings (Proxy Voting Disclosures) are used by registered investment companies, such as mutual funds and ETFs, and certain institutional investment managers, such as hedge funds and pension funds, to disclose how they voted on shareholder proposals in proxy voting. Each filing reports the details, such as name, CUSIP and ISIN, of the company that held the shareholder meeting, date of the meeting, proposal description (e.g. executive compensation, coporate governance, etc.), whether the vote was cast for or against the proposal, the number of shares voted, and more. Submitted annually to the SEC by August 31st each year, Form N-PX filings cover proxy votes during the previous 12 months, from July 1st to June 30th of the current year.

Metadata of a Form N-PX filing in JSON format


          1
          {
        

          2
            "accessionNo": "0000005138-24-000043",
        

          3
            "formType": "N-PX",
        

          4
            "filedAt": "2024-07-22T16:05:55-04:00",
        

          5
            "periodOfReport": "2024-06-30",
        

          6
            "cik": "5138",
        

          7
            "companyName": "AMERICAN GROWTH FUND INC",
        

          8
            "headerData": {
        

          9
              "filerInfo": {
        

          10
                "registrantType": "RMIC",
        

          11
                "investmentCompanyType": "N-1A",
        

          12
              },
        

          13
              "seriesClass": {
        

          14
                "reportSeriesClass": {
        

          15
                  "rptSeriesClassInfo": [
        

          16
                    {
        

          17
                      "seriesId": "S000012125",
        

          18
                      "includeAllClassesFlag": true
        

          19
                    }
        

          20
                  ]
        

          21
                }
        

          22
              }
        

          23
            },
        

          24
            "formData": {
        

          25
              "coverPage": {
        

          26
                "yearOrQuarter": "YEAR",
        

          27
                "reportCalendarYear": "2024",
        

          28
                "reportingPerson": {
        

          29
                  "name": "AMERICAN GROWTH FUND INC",
        

          30
                  "phoneNumber": "303-626-0600",
        

          31
                  "address": {
        

          32
                    "street1": "1636 Logan Street",
        

          33
                    "city": "Denver",
        

          34
                    "stateOrCountry": "CO",
        

          35
                    "zipCode": "80203"
        

          36
                  }
        

          37
                },
        

          38
                "reportInfo": { "reportType": "FUND VOTING REPORT" },
        

          39
                "fileNumber": "811-00825",
        

          40
                "explanatoryInformation": { "explanatoryChoice": false }
        

          41
              },
        

          42
              "summaryPage": { "otherIncludedManagersCount": 0 },
        

          43
              "seriesPage": {
        

          44
                "seriesCount": 1,
        

          45
                "seriesDetails": {
        

          46
                  "seriesReports": [
        

          47
                    {
        

          48
                      "idOfSeries": "S000012125",
        

          49
                      "nameOfSeries": "American Growth Fund,Inc. Series One",
        

          50
                      "leiOfSeries": "00000000000000000000"
        

          51
                    }
        

          52
                  ]
        

          53
                }
        

          54
              },
        

          55
              "signaturePage": {
        

          56
                "reportingPerson": "AMERICAN GROWTH FUND INC",
        

          57
                "txSignature": "Timothy E. Taggart",
        

          58
                "txPrintedSignature": "Timothy E. Taggart",
        

          59
                "txTitle": "President",
        

          60
                "txAsOfDate": "07/22/2024"
        

          61
              }
        

          62
            },
        

          63
            "proxyVotingRecordsAttached": true
        

          64
          }

Dataset size:

More than 10,000 Form N-PX filings originally filed in XML format since January 1, 2024 to present.

Data update frequency:

New filings are indexed and searchable within 300 milliseconds of being published on EDGAR. In rare cases of exceptionally large filings, this latency may be higher.

Survivorship bias free:

Yes. The dataset includes all Form N-PX filings, covering both active and inactive funds.

API Endpoints

Form N-PX Search API

The N-PX Search API allows searching and filtering all N-PX filings published on the SEC EDGAR database since 2024 to present. The API accepts search queries as JSON formatted payload and returns the matching N-PX filings in JSON format. The API endpoint is:

https://api.sec-api.io/form-npx

Supported HTTP methods: POST

Request and response content type: JSON

Voting Records API

Due to their size - sometimes exceeding 200MB and 420,000 records - proxy voting records are available for separate download via a GET request using the filing's accession number.

https://api.sec-api.io/form-npx/<accession-number>

Supported HTTP methods: GET

Response content type: JSON

Example: GET request to https://api.sec-api.io/form-npx/0001021408-24-007161 to download the proxy voting records in structured JSON format for the filing with accession number 0001021408-24-007161.

Authentication

To authenticate API requests, use the API key displayed in your user profile. Utilize the API key in one of two ways. Choose the method that best fits your use case:

Authorization Header: Set the API key as an Authorization header. For instance, before sending a POST request to https://api.sec-api.io/form-npx, ensure the header is set as follows: Authorization: YOUR_API_KEY. Do not include any prefix like Bearer.
Query Parameter: Alternatively, append the API key directly to the URL as a query parameter. For example, when making a GET request, use the URL https://api.sec-api.io/form-npx/0001021408-24-007161?token=YOUR_API_KEY instead of the base endpoint.

Form N-PX Search API

To search the Form N-PX database and find proxy voting records, send a POST request to https://api.sec-api.io/form-npx, providing the search criteria as a JSON payload. All Form N-PX filing properties are searchable and listed in the Response Structure section below. The Search API returns the metadata of matching N-PX filings in JSON format.

Request Structure - Search API

The following request parameters are supported:

query (string) - The search criteria in the format field:value defining thefield to search in and the value to search for in this field. The search expression is written in Lucene syntax and supports AND and OR operators. Examples: cik:4568 or filedAt:[2019-01-01 TO 2022-12-31].
from (integer) - Pagination control to specify the starting position of the results. Max: 10000. Default: 0.
size (integer) - The number of N-PX filings to be returned in one response. Default: 50. Max: 50.
sort (array) - Specifies the field by which results should be sorted. By default, results are sorted by filedAt in descending order, starting with the most recent filings: [{ "filedAt": { "order": "desc" } }]

Request Examples

Search N-PX filings by CIK: Find the two most recently submitted N-PX filings for the company with CIK 2110.