GET /v1/edgar/filings/search

$0.03delayed_15mtier: datacache 900sEngine D — Gov Data / EDGAR

Proxies SEC EDGAR full-text search (efts.sec.gov) with fair-access rate limiting and returns normalized hits: company, form, filing date, matched document, and archive URL. Upstream provides no text excerpt, so snippets describe the matched document.

Parameters

NameInTypeRequiredNotes
qquerystringyesFull-text query; quote phrases for exact match
form_typequerystringnoe.g. "8-K", "10-K", "S-1"
tickerquerystringno
date_fromquerystringno
date_toquerystringno
limitqueryintegerno (default: 10)

Example

curl "https://x402-factory.com/v1/edgar/filings/search?q=supply%20agreement&form_type=8-K"

Example response

{
  "data": {
    "results": [
      {
        "company": "ENDWAVE CORP",
        "form": "8-K",
        "filed_at": "2005-03-25",
        "snippet": "8-K filed 2005-03-25 — matched document: exhibit2.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1118941/000129993305001414/exhibit2.htm"
      },
      {
        "company": "TRIMOL GROUP INC",
        "form": "8-K",
        "filed_at": "2006-09-26",
        "snippet": "8-K filed 2006-09-26 — matched document: d69435_ex99-4.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1011733/000116923206003873/d69435_ex99-4.htm"
      },
      {
        "company": "HOKU SCIENTIFIC INC",
        "form": "8-K",
        "filed_at": "2008-09-04",
        "snippet": "8-K filed 2008-09-04 — matched document: v125567_8k.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1178336/000114420408051247/v125567_8k.htm"
      },
      {
        "company": "DEL MONTE FOODS CO",
        "form": "8-K",
        "filed_at": "2008-10-09",
        "snippet": "8-K filed 2008-10-09 — matched document: f50037exv10w2.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/866873/000095013408017772/f50037exv10w2.htm"
      },
      {
        "ticker": "MTEX",
        "company": "MANNATECH INC",
        "form": "8-K",
        "filed_at": "2007-01-31",
        "snippet": "8-K filed 2007-01-31 — matched document: dex991.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1056358/000119312507017417/dex991.htm"
      },
      {
        "company": "WJ COMMUNICATIONS INC",
        "form": "8-K",
        "filed_at": "2004-07-02",
        "snippet": "8-K filed 2004-07-02 — matched document: a04-7543_1ex10d1.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/105006/000110465904018927/a04-7543_1ex10d1.htm"
      },
      {
        "company": "TRIMOL GROUP INC",
        "form": "8-K",
        "filed_at": "2006-06-27",
        "snippet": "8-K filed 2006-06-27 — matched document: d68533_ex99-3.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1011733/000116923206002871/d68533_ex99-3.htm"
      },
      {
        "company": "HOKU SCIENTIFIC INC",
        "form": "8-K",
        "filed_at": "2008-05-13",
        "snippet": "8-K filed 2008-05-13 — matched document: v113857_8k.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1178336/000114420408027951/v113857_8k.htm"
      },
      {
        "company": "Patient Safety Technologies, Inc",
        "form": "8-K",
        "filed_at": "2005-08-23",
        "snippet": "8-K filed 2005-08-23 — matched document: v024587_ex10-1.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/812301/000114420405026705/v024587_ex10-1.htm"
      },
      {
        "ticker": "BKR",
        "company": "Baker Hughes a GE Co",
        "form": "8-K",
        "filed_at": "2018-11-13",
        "snippet": "8-K filed 2018-11-13 — matched document: dp98267_ex1005.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/1701605/000095010318013305/dp98267_ex1005.htm"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/edgar/filings/search",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.753Z",
    "freshness": "delayed_15m",
    "sources": [
      "edgar"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/gov.edgar-filings-search",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "form": {
            "type": "string"
          },
          "filed_at": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "company",
          "form",
          "filed_at",
          "snippet",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.03 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.