API Documentation

API Version: v1

10-K/Q Document Sections API

Retrieve parsed sections from SEC 10-K/Q documents

Overview

Endpoint

GET api.secblast.com/v1/document_sections

Description

Retrieve parsed sections from a specific SEC 10-K/Q document. Each section contains structured content including item labels (like "1", "1A", "7"), descriptions (like "Business", "Risk Factors", "MD&A"), and the full HTML content of the section. For 10-Q documents, the sections will also identify which part of the document (Part 1 or Part 2) they originated from.

Request Parameters

ParameterTypeDescription
api_keystringRequiredYour API key
document_idstringRequiredDocument ID (e.g., 0000002488-25-000012-1)
strip_htmlbooleanOptionalWhen set to true, strips HTML tags from the content and returns clean text. Default is false.

Response Format

{
  "sections": [
    {
      "id": "0000002488-25-000012-1.1",
      "document_id": "0000002488-25-000012-1",
      "item_label": "Item 1",
      "item_description": "Business",
      "content": "<div>Advanced Micro Devices, Inc. (AMD) is a global semiconductor company...</div>"
    },
    {
      "id": "0000002488-25-000012-1.1A",
      "document_id": "0000002488-25-000012-1",
      "item_label": "Item 1A",
      "item_description": "Risk Factors",
      "content": "<div>Investment in our securities involves risk...</div>"
    },
    {
      "id": "0000002488-25-000012-1.7",
      "document_id": "0000002488-25-000012-1",
      "item_label": "Item 7",
      "item_description": "Management's Discussion and Analysis of Financial Condition and Results of Operations",
      "content": "<div>The following discussion and analysis...</div>"
    },
    {
      "id": "0000002488-25-000012-1.8",
      "document_id": "0000002488-25-000012-1",
      "item_label": "Item 8",
      "item_description": "Financial Statements and Supplementary Data",
      "content": "<div>Our consolidated financial statements...</div>"
    }
  ],
  "count": 23,
  "error": ""
}

Example Request

# Basic request
curl "https://api.secblast.com/v1/document_sections?api_key=YOUR_API_KEY&document_id=0000002488-25-000012-1"

# With HTML stripping enabled
curl "https://api.secblast.com/v1/document_sections?api_key=YOUR_API_KEY&document_id=0000002488-25-000012-1&strip_html=true"

Error Responses

400 Bad Request: Missing document_id parameter

{
  "sections": [],
  "count": 0,
  "error": "Document ID is required"
}

500 Internal Server Error: Error retrieving sections

{
  "sections": [],
  "count": 0,
  "error": "Error retrieving sections"
}

Interactive API Explorer

Test the sections endpoint