Endpoint reference

Every endpoint of the SECSift API, with its parameters, an example call, and the answer the API gave. Every path sits under https://api.secsift.com/v1, takes GET requests, and needs your key in the Authorization header.

Path parameters are part of the path, and query parameters go after a question mark, like ?limit=5. A parameter that takes true also takes 1, and one that takes false also takes 0.

The examples read Apple's FY2025 10-K, and the answers are from October 2026. Open "Send this call" under an endpoint to run the example with your own key.

Companies

Search companies

GET /companies

Finds a company by ticker, name, or CIK, with up to 8 matches in data. A company without a ticker has null as its ticker, and a search that matches nothing returns an empty list.

ParameterInDescription
qqueryRequired. A ticker, company name, or CIK, up to 60 characters.

Example call:

curl "https://api.secsift.com/v1/companies?q=apple" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "data": [
    {
      "name": "Apple Inc.",
      "ticker": "AAPL",
      "cik": 320193
    },
    {
      "name": "Apple iSports Group, Inc.",
      "ticker": "AAPI",
      "cik": 1134982
    }
  ]
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies?q=apple

Get a company

GET /companies/{company}

A company's name, ticker, CIK, exchange, and industry.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer 
{
  "name": "Apple Inc.",
  "ticker": "AAPL",
  "cik": 320193,
  "exchange": "NASDAQ",
  "industry": "Electronic Computers"
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL

Filings

List filings

GET /companies/{company}/filings

Lists a company's filings, newest first. Without forms or all, the answer is the default list, a recent window of up to 24 filings of each kind. See filings and sections.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
allquerySet to true for every filing since 2001, amendments included, up to the newest 1,000 past the default list.
formsqueryForm codes, like 10-K,10-Q. With 10-K, 10-Q, 20-F, or 40-F, the list reaches back to 2001, up to 40 filings of each.
itemsquery8-K items, like 2.02 for earnings. An 8-K that reports any of them matches.
categoryqueryOne or more of annual, quarterly, current, insiders, ownership, proxies, registrations, and other.
fromqueryThe earliest filing date, like 2025-01-01.
toqueryThe latest filing date.
limitqueryFilings per page, from 1 to 200. The default is 50.
offsetqueryWhere the page starts, from 0. Send back next_offset for the next page.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings?forms=10-K&limit=1" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer 
{
  "data": [
    {
      "accession": "0000320193-25-000079",
      "form": "10-K",
      "tag": "10-K",
      "category": "annual",
      "items": null,
      "filed": "2025-10-31",
      "period_end": "2025-09-27",
      "fiscal": "FY2025",
      "urls": {
        "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079",
        "edgar": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html"
      }
    }
  ],
  "total": 24,
  "next_offset": 1,
  "capped": false
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings?forms=10-K&limit=1

Get a filing

GET /companies/{company}/filings/{accession}

A filing's form, dates, fiscal label, and 8-K items, every section with its id, item number, label, title, and part, and counts of the filing's tables and words.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "company": {
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193
  },
  "filing": {
    "accession": "0000320193-25-000079",
    "form": "10-K",
    "filed": "2025-10-31",
    "period_end": "2025-09-27",
    "fiscal": "FY2025",
    "items": null
  },
  "sections": [
    {
      "id": "part-i",
      "item": null,
      "label": "Part I",
      "title": null,
      "part": "I"
    },
    {
      "id": "pt-i-item-1",
      "item": "1",
      "label": "Item 1",
      "title": "Business",
      "part": "I"
    },
    {
      "id": "pt-i-item-1a",
      "item": "1A",
      "label": "Item 1A",
      "title": "Risk Factors",
      "part": "I"
    }
  ],
  "tables": 46,
  "words": 25819,
  "urls": {
    "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079",
    "edgar": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html"
  }
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079

Get a section

GET /companies/{company}/filings/{accession}/sections/{section}

One section's full text in text, up to 50,000 characters a call, with tables as Markdown. When a section runs longer, next_offset continues the text.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.
sectionpathThe section's id, its item number like 7 or 1A, or words from its label or title, up to 80 characters. A 10-Q's Part II items take their id, like pt-ii-item-2.
offsetqueryThe character to start from, from 0. Send back next_offset to continue.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/sections/7" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "company": {
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193
  },
  "filing": {
    "accession": "0000320193-25-000079",
    "form": "10-K",
    "filed": "2025-10-31",
    "period_end": "2025-09-27",
    "fiscal": "FY2025",
    "items": null
  },
  "section": {
    "id": "pt-ii-item-7",
    "item": "7",
    "label": "Item 7",
    "title": "Management’s Discussion and Analysis of Financial Condition and Results of Operations"
  },
  "text": "Item 7. Management’s Discussion and Analysis of Financial Condition and Results of Operations\n\nThe following discussion should be read in conjunction with the consolidated financial statements and accompanying notes included in Part II, Item 8 of this Form 10-K. …",
  "chars": 18755,
  "next_offset": null,
  "urls": {
    "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&item=7"
  }
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/sections/7

Tables

List tables

GET /companies/{company}/filings/{accession}/tables

Every table in a filing, with its number, title, section, row and column counts, and units, plus its first 12 headers and first 8 row labels. See tables and numbers.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "company": {
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193
  },
  "filing": {
    "accession": "0000320193-25-000079",
    "form": "10-K",
    "filed": "2025-10-31",
    "period_end": "2025-09-27",
    "fiscal": "FY2025",
    "items": null
  },
  "data": [
    {
      "n": 12,
      "title": "Consolidated Statements of Operations",
      "section": "Item 8",
      "section_id": "pt-ii-item-8",
      "section_title": "Financial Statements and Supplementary Data",
      "rows": 24,
      "columns": 4,
      "units": {
        "scale": "millions",
        "multiplier": 1000000
      },
      "headers": ["", "Years ended September 27, 2025", "Years ended September 28, 2024", "Years ended September 30, 2023"],
      "labels": ["Net sales:", "Products", "Services", "Total net sales", "Cost of sales:", "Products", "Services", "Total cost of sales"],
      "urls": {
        "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&tb=b426&tn=12"
      }
    }
  ]
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables

Get a table

GET /companies/{company}/filings/{accession}/tables/{n}

One table, as filed and as numbers, with what to multiply each figure by and each row's kind.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.
npathThe table's number, from the filing's list of tables.
formatqueryjson (the default) or csv for the headers and rows as filed.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/12" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "company": {
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193
  },
  "filing": {
    "accession": "0000320193-25-000079",
    "form": "10-K",
    "filed": "2025-10-31",
    "period_end": "2025-09-27",
    "fiscal": "FY2025",
    "items": null
  },
  "n": 12,
  "title": "Consolidated Statements of Operations",
  "section": "Item 8",
  "units": {
    "scale": "millions",
    "multiplier": 1000000
  },
  "headers": ["", "Years ended September 27, 2025", "Years ended September 28, 2024", "Years ended September 30, 2023"],
  "rows": [
    ["Total net sales", "416,161", "391,035", "383,285"],
    ["Net income", "$112,010", "$93,736", "$96,995"],
    ["Diluted", "$7.46", "$6.08", "$6.13"]
  ],
  "values": [
    [null, 416161, 391035, 383285],
    [null, 112010, 93736, 96995],
    [null, 7.46, 6.08, 6.13]
  ],
  "multipliers": [
    [null, 1000000, 1000000, 1000000],
    [null, 1000000, 1000000, 1000000],
    [null, null, null, null]
  ],
  "row_kinds": [null, null, "per_share"],
  "urls": {
    "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&tb=b426&tn=12",
    "edgar": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html"
  }
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/12

Get table history

GET /companies/{company}/filings/{accession}/tables/{n}/history

The same table across the company's filings of the same form, with the rows lined up by label. See table history.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.
npathThe table's number, from the filing's list of tables.
limitqueryHow many filings, counting yours, from 2 to 20. The default is 8, and more than 12 counts as 2 calls.
orderqueryfiled (the default), newest, or oldest.
dedupequerySet to true to show each period once, from the newest filing that has it.
partialquerySet to false to get the table only once every filing is ready. Until then, the answer is a 202 that lists each filing's status, and those 202s don't count as calls.
formatqueryjson (the default) or csv.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/12/history?limit=3&dedupe=true" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "title": "Consolidated Statements of Operations",
  "filings": [
    {
      "accession": "0000320193-25-000079",
      "form": "10-K",
      "fiscal": "FY2025",
      "filed": "2025-10-31",
      "period_end": "2025-09-27",
      "status": "matched",
      "match": 1,
      "table": 12
    },
    {
      "accession": "0000320193-24-000123",
      "form": "10-K",
      "fiscal": "FY2024",
      "filed": "2024-11-01",
      "period_end": "2024-09-28",
      "status": "matched",
      "match": 1,
      "table": 12
    },
    {
      "accession": "0000320193-23-000106",
      "form": "10-K",
      "fiscal": "FY2023",
      "filed": "2023-11-03",
      "period_end": "2023-09-30",
      "status": "matched",
      "match": 1,
      "table": 11
    }
  ],
  "headers": ["Line item", "Years ended September 27, 2025", "Years ended September 28, 2024", "Years ended September 30, 2023", "Years ended September 24, 2022", "Years ended September 25, 2021"],
  "columns": [
    {
      "header": "Line item",
      "accession": null,
      "period_type": null,
      "url": null
    },
    {
      "header": "Years ended September 27, 2025",
      "accession": "0000320193-25-000079",
      "period_type": "annual",
      "url": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&tb=b426&tn=12"
    },
    {
      "header": "Years ended September 28, 2024",
      "accession": "0000320193-25-000079",
      "period_type": "annual",
      "url": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&tb=b426&tn=12"
    },
    {
      "header": "Years ended September 30, 2023",
      "accession": "0000320193-25-000079",
      "period_type": "annual",
      "url": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&tb=b426&tn=12"
    },
    {
      "header": "Years ended September 24, 2022",
      "accession": "0000320193-24-000123",
      "period_type": "annual",
      "url": "https://secsift.com/?t=AAPL&a=0000320193-24-000123&tb=b440&tn=12"
    },
    {
      "header": "Years ended September 25, 2021",
      "accession": "0000320193-23-000106",
      "period_type": "annual",
      "url": "https://secsift.com/?t=AAPL&a=0000320193-23-000106&tb=b434&tn=11"
    }
  ],
  "rows": [
    ["Total net sales", "416,161", "391,035", "383,285", "394,328", "365,817"],
    ["Net income", "$112,010", "$93,736", "$96,995", "$99,803", "$94,680"]
  ],
  "values": [
    [null, 416161, 391035, 383285, 394328, 365817],
    [null, 112010, 93736, 96995, 99803, 94680]
  ],
  "multipliers": [
    [null, 1000000, 1000000, 1000000, 1000000, 1000000],
    [null, 1000000, 1000000, 1000000, 1000000, 1000000]
  ],
  "row_kinds": [null, null],
  "complete": true
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/12/history?limit=3&dedupe=true

A history of more than 12 filings costs 2 calls.

Name tables

GET /companies/{company}/filings/{accession}/tables/names

AI names for every table in a filing, at 2 calls for each table. ai is false only when no name came back, and calls says what the names cost.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/names" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer

Lists and text are shortened.

{
  "data": [
    {
      "n": 1,
      "name": "Securities registered pursuant to Section 12(b) of the Act",
      "ai": true
    },
    {
      "n": 2,
      "name": "Share repurchase activity",
      "ai": true
    },
    {
      "n": 3,
      "name": "Five-year cumulative total shareholder return",
      "ai": true
    }
  ],
  "tables": 46,
  "calls": 92
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/tables/names

Names cost 2 calls for each table in the filing, so Apple's FY2025 10-K costs 92.

Compare

Compare filings

GET /companies/{company}/filings/{accession}/compare

What's new, changed, or removed in a filing since an earlier one, one kind at a time, in the filing's order. See filing comparison.

ParameterInDescription
companypathA ticker like AAPL or a CIK like 320193.
accessionpathThe filing's accession number, from the filings list.
priorqueryRequired. The accession number of the filing to compare against, from the same company, usually the company's previous filing of the same form.
kindquerychanged (the default), new, or removed.
limitqueryEntries per page, from 1 to 200. The default is 50.
offsetqueryWhere the page starts, from 0. Send back next_offset for the next page.

Example call:

curl "https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/compare?prior=0000320193-24-000123&limit=1" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer 
{
  "company": {
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193
  },
  "filing": {
    "accession": "0000320193-25-000079",
    "form": "10-K",
    "filed": "2025-10-31",
    "period_end": "2025-09-27",
    "fiscal": "FY2025",
    "items": null
  },
  "prior_accession": "0000320193-24-000123",
  "counts": {
    "new": 37,
    "changed": 213,
    "removed": 89
  },
  "kind": "changed",
  "data": [
    {
      "text": "For the fiscal year ended September 27, 2025",
      "prior": "For the fiscal year ended September 28, 2024",
      "table": null,
      "cells": null,
      "new_rows": null,
      "new_columns": null,
      "section": null,
      "urls": {
        "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079&b=b6"
      }
    }
  ],
  "total": 213,
  "next_offset": 1,
  "truncated": false
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/companies/AAPL/filings/0000320193-25-000079/compare?prior=0000320193-24-000123&limit=1

Search filings

GET /search

Searches every filing on EDGAR for words or a phrase, over the past year by default and back to 2001 with from. See full-text search.

ParameterInDescription
qqueryThe words to find, 3 to 200 characters, with quotes for a phrase and OR, NOT, and brackets. Required unless forms is sent.
formsqueryForm codes such as 10-K, or a group such as reports or proxies.
fromqueryThe earliest filing date, back to 2001-01-01.
toqueryThe latest filing date. The default is today.
companiesqueryTickers or CIKs, up to 10 tickers and 250 CIKs.
headquartersqueryA state, a country, or United States, Canada, or Elsewhere.
variationsquerySet to true to also find other forms of each word.
pagequeryWhich page of results, from 0 to 9.

Example call:

curl "https://api.secsift.com/v1/search?q=%22supply%20chain%22&forms=10-K&companies=AAPL" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer 
{
  "query": "\"supply chain\"",
  "phrase": "supply chain",
  "total": 1,
  "capped": false,
  "page": 0,
  "pages": 1,
  "forms": [
    {
      "form": "10-K",
      "count": 1
    }
  ],
  "unknown_forms": [],
  "unknown_places": [],
  "unknown_companies": [],
  "hint": null,
  "data": [
    {
      "id": "0000320193-25-000079:aapl-20250927.htm",
      "cik": 320193,
      "company": "Apple Inc.",
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "form": "10-K",
      "document": "Main document",
      "main": true,
      "industry": "Electronic Computers",
      "headquarters": "Cupertino, CA",
      "float": 3253431000000,
      "float_label": "$3.3T",
      "float_as_of": "2025-03-28",
      "period": "2025-09-27",
      "filed": "2025-10-31",
      "accession": "0000320193-25-000079",
      "items": [],
      "urls": {
        "secsift": "https://secsift.com/?t=AAPL&a=0000320193-25-000079"
      }
    }
  ]
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/search?q=%22supply%20chain%22&forms=10-K&companies=AAPL

A search also counts toward the site's search allowance.

Account

Get usage

GET /usage

Your plan, the calls you made today, your daily limit, the calls left, and when the count resets. A call to /usage counts too.

This endpoint takes no parameters.

Example call:

curl "https://api.secsift.com/v1/usage" \
  -H "Authorization: Bearer $SECSIFT_KEY"
Example answer 
{
  "plan": "pro",
  "calls_today": 207,
  "daily_limit": 5000,
  "remaining": 4793,
  "resets_at": "2026-10-27T00:00:00.000Z"
}
Send this call

Paste a key from "API keys" in the reader. The key stays in this tab, and each send counts toward your daily calls.

GET https://api.secsift.com/v1/usage