Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/polygon-reference-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: The future of fintech.
title: Polygon Reference API
version: 1.0.0
servers:
- description: Polygon Platform API
url: https://api.polygon.io
- description: Polygon Platform API (Staging)
url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- description: Reference API
name: reference
x-polygon-sub-tags:
- tickers:list
- tickers:types
- tickers:get
- options:contracts:list
- news
- tickers
- stocks
- sec:filings
- sec:filing
- sec:filing:files
- sec:filing:file
- stocks:market
- conditions
- stocks:meta:exchanges
- crypto
- exchanges
paths:
/stocks/filings/10-K/vX/sections:
get:
description: SEC document text sections providing raw text content from specific sections of SEC filings (10-K, 10-Q, etc.).
operationId: get_stocks_filings_10-K_vX_sections
parameters:
- description: SEC Central Index Key (10 digits, zero-padded).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: cik.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: cik.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: cik.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: cik.lte
schema:
type: string
- description: Stock ticker symbol for the company.
in: query
name: ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: ticker.lte
schema:
type: string
- description: Standardized section identifier from the filing (e.g. 'business', 'risk_factors', etc.).
in: query
name: section
schema:
enum:
- business
- risk_factors
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: section.any_of
schema:
enum:
- business
- risk_factors
type: string
- description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lte
schema:
type: string
- description: Period end date that the filing relates to (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lte
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '10' if not specified. The maximum allowed limit is '100'.
in: query
name: limit
schema:
default: 10
maximum: 100
minimum: 1
type: integer
- description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'period_end' if not specified. The sort order defaults to 'desc' if not specified.
in: query
name: sort
schema:
default: period_end.desc
type: string
responses:
'200':
content:
application/json:
example:
count: 2
next_url: https://api.massive.com/stocks/filings/10-K/vX/sections?cursor=eyJsaW1pd...
request_id: a3f8b2c1d4e5f6g7
results:
- cik: 0000320193
filing_date: '2023-11-03'
filing_url: https://www.sec.gov/Archives/edgar/data/320193/0000320193-23-000106.txt
period_end: '2023-09-30'
section: risk_factors
text: 'Item 1A. Risk Factors
Investing in our stock involves risk. In addition to the other information in this Annual Report on Form 10-K, the following risk factors should be carefully considered...'
ticker: AAPL
- cik: 0000789019
filing_date: '2023-07-27'
filing_url: https://www.sec.gov/Archives/edgar/data/789019/0000950170-23-035122.txt
period_end: '2023-06-30'
section: risk_factors
text: 'Item 1A. RISK FACTORS
Our operations and financial results are subject to various risks and uncertainties...'
ticker: MSFT
status: OK
schema:
properties:
next_url:
description: If present, this value can be used to fetch the next page.
type: string
request_id:
description: A request id assigned by the server.
type: string
results:
description: The results for this request.
items:
properties:
cik:
description: SEC Central Index Key (10 digits, zero-padded).
type: string
filing_date:
description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
format: date
type: string
filing_url:
description: SEC URL source for the full filing.
type: string
period_end:
description: Period end date that the filing relates to (formatted as YYYY-MM-DD).
format: date
type: string
section:
description: Standardized section identifier from the filing (e.g. 'business', 'risk_factors', etc.).
type: string
text:
description: Full raw text content of the section, including headers and formatting.
type: string
ticker:
description: Stock ticker symbol for the company.
type: string
type: object
type: array
status:
description: The status of this request's response.
enum:
- OK
type: string
required:
- status
- request_id
- results
type: object
description: A list of results.
'400':
content:
application/json:
schema:
properties:
error:
description: A message describing the source of the error.
type: string
request_id:
description: A request id assigned by the server.
type: string
status:
description: The status of this request's response.
enum:
- ERROR
type: string
required:
- status
- request_id
- error
type: object
description: An error message.
tags:
- reference
/stocks/filings/10-K/vX_0/sections:
get:
description: SEC document text sections providing raw text content from specific sections of SEC filings (10-K, 10-Q, etc.).
operationId: get_stocks_filings_10-K_vX_0_sections
parameters:
- description: SEC Central Index Key (10 digits, zero-padded).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: cik.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: cik.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: cik.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: cik.lte
schema:
type: string
- description: Stock ticker symbol for the company.
in: query
name: ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: ticker.lte
schema:
type: string
- description: Standardized section identifier from the filing (e.g. 'business', 'risk_factors', etc.).
in: query
name: section
schema:
enum:
- business
- risk_factors
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: section.any_of
schema:
enum:
- business
- risk_factors
type: string
- description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lte
schema:
type: string
- description: Period end date that the filing relates to (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lte
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '10' if not specified. The maximum allowed limit is '100'.
in: query
name: limit
schema:
default: 10
maximum: 100
minimum: 1
type: integer
- description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'period_end' if not specified. The sort order defaults to 'desc' if not specified.
in: query
name: sort
schema:
default: period_end.desc
type: string
responses:
'200':
content:
application/json:
example:
count: 2
next_url: https://api.massive.com/stocks/filings/10-K/vX/sections?cursor=eyJsaW1pd...
request_id: a3f8b2c1d4e5f6g7
results:
- cik: 0000320193
filing_date: '2023-11-03'
filing_url: https://www.sec.gov/Archives/edgar/data/320193/0000320193-23-000106.txt
period_end: '2023-09-30'
section: risk_factors
text: 'Item 1A. Risk Factors
Investing in our stock involves risk. In addition to the other information in this Annual Report on Form 10-K, the following risk factors should be carefully considered...'
ticker: AAPL
- cik: 0000789019
filing_date: '2023-07-27'
filing_url: https://www.sec.gov/Archives/edgar/data/789019/0000950170-23-035122.txt
period_end: '2023-06-30'
section: risk_factors
text: 'Item 1A. RISK FACTORS
Our operations and financial results are subject to various risks and uncertainties...'
ticker: MSFT
status: OK
schema:
properties:
next_url:
description: If present, this value can be used to fetch the next page.
type: string
request_id:
description: A request id assigned by the server.
type: string
results:
description: The results for this request.
items:
properties:
cik:
description: SEC Central Index Key (10 digits, zero-padded).
type: string
filing_date:
description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
format: date
type: string
filing_url:
description: SEC URL source for the full filing.
type: string
period_end:
description: Period end date that the filing relates to (formatted as YYYY-MM-DD).
format: date
type: string
section:
description: Standardized section identifier from the filing (e.g. 'business', 'risk_factors', etc.).
type: string
text:
description: Full raw text content of the section, including headers and formatting.
type: string
ticker:
description: Stock ticker symbol for the company.
type: string
type: object
type: array
status:
description: The status of this request's response.
enum:
- OK
type: string
required:
- status
- request_id
- results
type: object
description: A list of results.
'400':
content:
application/json:
schema:
properties:
error:
description: A message describing the source of the error.
type: string
request_id:
description: A request id assigned by the server.
type: string
status:
description: The status of this request's response.
enum:
- ERROR
type: string
required:
- status
- request_id
- error
type: object
description: An error message.
tags:
- reference
/stocks/filings/8-K/vX/disclosures:
get:
description: SEC 8-K filing disclosure categorization. A single 8-K filing can produce multiple rows when it covers multiple disclosure types — each row represents one tagged disclosure within the filing, classified into primary, secondary, and tertiary categories with a supporting text excerpt. The full classification list is available at /stocks/taxonomies/vX/disclosures.
operationId: get_stocks_filings_8-K_vX_disclosures
parameters:
- description: SEC Central Index Key of the filer (10 digits, zero-padded).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter for arrays that contain the value.
in: query
name: tickers
schema:
type: string
- description: Filter for arrays that contain all of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.all_of
schema:
type: string
- description: Filter for arrays that contain any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.any_of
schema:
type: string
- description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
in: query
name: filing_date
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: filing_date.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: filing_date.lte
schema:
type: string
- description: Most specific disclosure category (e.g., 'quarterly_results'). Filtering on this column must use an exact match. See the full taxonomy at /stocks/taxonomies/vX/disclosures.
in: query
name: tertiary_category
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '1000'.
in: query
name: limit
schema:
default: 100
maximum: 1000
minimum: 1
type: integer
- description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'filing_date' if not specified. The sort order defaults to 'desc' if not specified.
in: query
name: sort
schema:
default: filing_date.desc
type: string
responses:
'200':
content:
application/json:
example:
count: 2
next_url: https://api.massive.com/stocks/filings/8-K/vX/disclosures?cursor=eyJsaW1pd...
request_id: b4e7c2a1f3d8e9g0
results:
- accession_number: 0000320193-25-000010
cik: 0000320193
filing_date: '2025-01-14'
filing_url: https://www.sec.gov/Archives/edgar/data/320193/0000320193-25-000010.txt
primary_category: financial_results
secondary_category: earnings_announcement
supporting_text: On January 14, 2025, Apple Inc. announced financial results for the fiscal quarter ended December 28, 2024.
tertiary_category: quarterly_results
tickers:
- AAPL
- accession_number: 0000004962-25-000002
cik: 0000004962
filing_date: '2025-01-15'
filing_url: https://www.sec.gov/Archives/edgar/data/4962/0000004962-25-000002.txt
primary_category: regulatory_compliance
secondary_category: regulation_fd
supporting_text: American Express Company is hereby furnishing below delinquency and write-off statistics for its U.S. Consumer and Small Business portfolios.
tertiary_category: financial_data_disclosure
tickers:
- AXP
status: OK
schema:
properties:
next_url:
description: If present, this value can be used to fetch the next page.
type: string
request_id:
description: A request id assigned by the server.
type: string
results:
description: The results for this request.
items:
properties:
accession_number:
description: Unique SEC accession number for the filing (e.g., '0000320193-25-000010').
type: string
cik:
description: SEC Central Index Key of the filer (10 digits, zero-padded).
type: string
filing_date:
description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
type: string
filing_url:
description: Direct URL to the full submission text file for the filing on SEC EDGAR.
type: string
primary_category:
description: Top-level disclosure category (e.g., 'financial_results'). See the full taxonomy at /stocks/taxonomies/vX/disclosures.
type: string
secondary_category:
description: Mid-level disclosure category (e.g., 'earnings_announcement'). See the full taxonomy at /stocks/taxonomies/vX/disclosures.
type: string
supporting_text:
description: A verbatim excerpt from the filing text supporting the assigned categories.
type: string
tertiary_category:
description: Most specific disclosure category (e.g., 'quarterly_results'). Filtering on this column must use an exact match. See the full taxonomy at /stocks/taxonomies/vX/disclosures.
type: string
tickers:
description: A list of ticker symbols for the filing company. Multiple symbols may indicate different share classes; empty if no ticker is currently mapped to the filer.
items:
type: string
type: array
type: object
type: array
status:
description: The status of this request's response.
enum:
- OK
type: string
required:
- status
- request_id
- results
type: object
description: A list of results.
'400':
content:
application/json:
schema:
properties:
error:
description: A message describing the source of the error.
type: string
request_id:
description: A request id assigned by the server.
type: string
status:
description: The status of this request's response.
enum:
- ERROR
type: string
required:
- status
- request_id
- error
type: object
description: An error message.
tags:
- reference
/stocks/filings/8-K/vX/text:
get:
description: SEC 8-K filings text providing parsed content from current report filings. 8-K forms report material events such as earnings, acquisitions, executive changes, and other significant corporate events.
operationId: get_stocks_filings_8-K_vX_text
parameters:
- description: SEC Central Index Key (10 digits, zero-padded).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: cik.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: cik.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: cik.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: cik.lte
schema:
type: string
- description: Stock ticker symbol for the company.
in: query
name: ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: ticker.lte
schema:
type: string
- description: SEC form type (e.g., '8-K', '8-K/A' for amendments).
in: query
name: form_type
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: form_type.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: form_type.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: form_type.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: form_type.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: form_type.lte
schema:
type: string
- description: Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lte
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '10' if not specified. The maximum allowed limit is '100'.
in: query
name: limit
schema:
default: 10
maximum: 100
minimum: 1
type: integer
- description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'filing_date' if not specified. The sort order defaults to 'desc' if not specified.
in: query
name: sort
schema:
default: filing_date.desc
type: string
responses:
'200':
content:
application/json:
example:
count: 2
next_url: https://api.massiv
# --- truncated at 32 KB (138 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-reference-api-openapi.yml