API Reference

Complete reference for all Zhane EDGAR API endpoints. Base URL: https://api.zctechnologies.org

Authentication

All endpoints except the free preview require a Bearer token.

Authorization: Bearer zk_your_api_key_here

Error Codes

Status	Meaning
200	Success
400	Bad request
401	Missing or invalid API key
404	Filing not found
429	Daily rate limit reached (Starter plan)
500	Internal error (SEC EDGAR temporarily unavailable)

GET /v1/filings/recent

Most recent 8-K filings, parsed and urgency-scored. No auth required for 5-result preview.

Query Parameters

Parameter	Type	Default	Description
`count`	integer	20	Number of filings. Max 40. Auth required for more than 5.

Response Schema

{
  "data": [{
    "accession": "string",      // e.g. "0001193125-26-142364"
    "company": "string",
    "cik": "string",
    "filed": "string",          // ISO date
    "items": {
      "5.02": {
        "name": "string",
        "urgency": 3,           // 1=LOW 2=MEDIUM 3=HIGH 4=CRITICAL
        "urgency_label": "HIGH"
      }
    },
    "max_urgency": 3,
    "max_urgency_label": "HIGH",
    "index_url": "string"
  }],
  "count": 20
}

Example

curl "https://api.zctechnologies.org/v1/filings/recent?count=10" -H "Authorization: Bearer zk_your_key"

GET /v1/signals

Only HIGH (urgency >= 3) and CRITICAL (urgency = 4) filings.

Level	Score	Examples
CRITICAL	4	Material impairments (2.06), Non-reliance on financials (4.02), Delisting notices (3.01)
HIGH	3	Agreement terminations (1.02), Layoffs (2.05), Auditor changes (4.01), Executive departures (5.02)

curl https://api.zctechnologies.org/v1/signals -H "Authorization: Bearer zk_your_key"

GET /v1/filings/:accession

Full filing detail. Fetches the actual document from SEC EDGAR and extracts items, dollar amounts, and context snippets.

Path Parameters

Parameter	Format	Example
`:accession`	`XXXXXXXXXX-YY-ZZZZZZ`	`0001193125-26-142364`

Query Parameters

Parameter	Type	Required	Description
`cik`	string	Optional	Company CIK. Required for filings not in recent 40.

Response Schema

{
  "accession": "string",
  "document_url": "string",
  "items": {
    "5.02": {
      "name": "Departure of Directors/Officers",
      "urgency": 3,
      "urgency_label": "HIGH",
      "context": "string"     // up to 500 chars from filing text
    }
  },
  "dollar_amounts": ["$2.1 billion", "$450 million"],
  "max_urgency": 3,
  "max_urgency_label": "HIGH",
  "text_length": 12847
}

curl "https://api.zctechnologies.org/v1/filings/0001193125-26-142364?cik=1920145" -H "Authorization: Bearer zk_your_key"

GET /v1/company/:cik

Up to 20 most recent 8-K filings for a company by CIK.

curl https://api.zctechnologies.org/v1/company/1045810 -H "Authorization: Bearer zk_your_key"

Response Schema

{
  "cik": 1045810,
  "name": "NVIDIA CORP",
  "tickers": ["NVDA"],
  "recent_8ks": [{ "form": "8-K", "filed": "2026-02-26", "accession": "0001045810-26-000012" }],
  "count": 20
}

POST /v1/subscribe

curl -X POST https://api.zctechnologies.org/v1/subscribe \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","plan":"starter"}'
// Response: {"checkout_url": "https://checkout.stripe.com/...", "plan": "starter"}

Item Reference

Item	Name	Urgency
1.01	Entry into Material Definitive Agreement	MEDIUM
1.02	Termination of Material Definitive Agreement	HIGH
2.01	Completion of Acquisition/Disposition	MEDIUM
2.02	Results of Operations	MEDIUM
2.05	Exit/Disposal Activities (Layoffs)	HIGH
2.06	Material Impairments	CRITICAL
3.01	Notice of Delisting	CRITICAL
4.01	Changes in Certifying Accountant	HIGH
4.02	Non-Reliance on Financial Statements	CRITICAL
5.02	Departure of Directors/Officers	HIGH
5.03	Amendments to Articles/Bylaws	LOW
7.01	Regulation FD Disclosure	LOW
8.01	Other Events	LOW

See Code Examples