/api/v1/scrapping/cik

Get filings for a specific CIK via EDGAR scrape.

Get filings for a specific CIK via EDGAR scrape. Returns filings filtered by form type and optional date range. Useful when you need EDGAR's search-result schema for a specific CIK rather than FinRadar's normalized schema.

10 tokensSince v1.0.0

Why use this

CIK-keyed live EDGAR scrape — pass a 10-char zero-padded CIK and a form type, receive that filer's filings of that type as scraped from EDGAR's search pages. Heavier than `GET /api/v1/sec/filings?cik=...` (which is the local-index path) — use this when: (a) the local index is missing recent filings for this CIK and you need EDGAR's live data, (b) you specifically need EDGAR's search-result schema, (c) you're following a tutorial that referenced this endpoint. Date filtering happens at SEC level so date-bounded queries are server-efficient. The non-standard CamelCase param names (`form_Type`, `start_Date`, `end_Date`) are preserved verbatim from EDGAR's URL convention.

Common use case

Given Apple's CIK (0000320193), retrieve their last 10 10-K filings from EDGAR directly with `cik=0000320193&form_Type=10-K&count=10`.

CIK-keyed live EDGAR scrape — heavier (10 tokens) than the local-index sibling GET /api/v1/sec/filings?cik=... (5 tokens). Use when you need EDGAR's live data for a CIK whose local index may be incomplete, or when following a tutorial that wired this endpoint specifically. Date filtering happens at SEC level so start_Date / end_Date reduce upstream load (unlike the form-type-agnostic root scrapper at /scrapping). The CamelCase parameter convention (form_Type, start_Date, end_Date) preserves EDGAR's URL convention verbatim — case-sensitive. To resolve a ticker → CIK, use GET /api/v1/sec/filings?ticker=... and read meta.cik, or GET /api/v1/sec/entities for the full entity catalog. For institutional 13F holdings drilling, prefer GET /api/v1/13f/filer/{cik}/holdings.

Parameters

Name	In	Required	Default	Allowed	Description	Example
cik	query	required	—	—	10-char zero-padded CIK to query (e.g. `0000320193` for Apple). Returns 400 BAD_REQUEST when missing. Resolve a ticker → CIK via [GET /api/v1/scrapping/cik](/docs/sec-filings/search-and-extraction/get-scrapping-cik) — wait, that's THIS endpoint — use [GET /api/v1/sec/entities](/docs/sec-filings/sec-filings-api/get-sec-entities) which returns `(entity_name, cik)` pairs, or query [GET /api/v1/sec/filings?ticker=...](/docs/sec-filings/sec-filings-api/get-sec-filings)'s response which surfaces the CIK in `meta.cik`.	0000320193
form_Type	query	optional	10-K	—	Form type to filter by (`10-K`, `10-Q`, `8-K`, `4`, `13F-HR`, `S-1`, etc. — see [SEC EDGAR form types](https://www.sec.gov/forms)). CamelCase param name preserved from EDGAR's URL convention. Defaults to `10-K`.	10-K
count	query	optional	10	—	Maximum number of filings to return (1-40 recommended). Date filtering happens at SEC level so this is the upper bound on EDGAR's return set, not just the post-filter count.	10
start_Date	query	optional	—	—	Lower-bound filing date in `YYYY-MM-DD` format. Filtered at SEC level — reduces upstream load.	2025-01-01
end_Date	query	optional	—	—	Upper-bound filing date in `YYYY-MM-DD` format. Filtered at SEC level.	2025-12-31

Response schema

Field	Type	Nullable	Description
query	object	no	Echo of the resolved query parameters used for the EDGAR scrape — useful for debugging when results don't match expectations.
query.formType	string	no	Echoed form type (uppercased).
query.result	integer	no	Count of filings returned in `filings[]` after EDGAR-level date filtering.
query.count	integer	no	Echoed `count` parameter — useful for assertion in tests.
filings	array	no	Array of filing records as scraped from SEC EDGAR's filer-detail pages. Schema uses EDGAR-native field names. Empty array on no match — never null.
filings[].accession_Number	string	no	SEC accession number in canonical 18-char dashed format `XXXXXXXXXX-YY-NNNNNN`.
filings[].cik	string	no	Filer CIK as zero-padded 10-character string. Echoes the input.
filings[].formType	string	no	Canonical SEC form type as filed (echoes the `form_Type` filter).
filings[].filingDate	string	no	ISO date `YYYY-MM-DD` of the filing's SEC acceptance date in ET. Within the `start_Date`..`end_Date` window when those filters are passed.
filings[].linkToFilingDetails	string	no	Canonical SEC EDGAR URL for the filing's index page. Pass to [GET /api/v1/sec/document?url=...](/docs/sec-filings/sec-filings-api/get-sec-document) to fetch the filing body.

Sample response

"query":
- "formType": "10-K"
- "result": 2
- "count": 10
}
"filings":
]

}

Errors

Status	Label	Description
200	OK	Request succeeded.
400	Bad Request	Invalid query, body, or path parameter.
401	Unauthorized	Missing or invalid Authorization header / api_Token.
402	Payment Required	Insufficient token balance for this call. Top up
429	Too Many Requests	Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits
500	Server Error	Unexpected server-side failure. Retry with backoff; report if persistent.

Code samples

Reveal credentials

curl "https://api.finradar.ai/api/v1/scrapping/cik?api_Token=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).