Docs
PricingSupportSign Up

/ownership/initial-holding-ids

Fetch holdings by id — the detail companion to the holding_ids returned by POST /ownership/initial-holdings/stats.

POST/api/v1/ownership/initial-holding-ids
Rate limit120 per minute

Request:

holding_idsint[]

Required. 1–100 positive integers. Duplicates are removed with a _warnings entry.

pageint ≥ 1

Default 1

page_sizeint 1–100

Counts filings.

Default 100

detailstring

"light" leaves out each filing's footnotes and each holding's footnote_refs. See Response detail.

Default "full"

Response: the paging fields and filings of POST /ownership/initial-holdings, plus missing_ids when some ids were not found and restricted_ids when some exist but are outside your plan's history window or coverage scope. Both are charged for.

Credits: ceil(n / 5) × 10 on the deduplicated id count (max 100).

Errors: 404 OWNERSHIP_HOLDING_NOT_FOUND when none of the requested ids exist (charged; the response carries missing_ids). 403 PLAN_TIER_INSUFFICIENT when every requested id that exists is outside your plan's scope (charged; the response carries restricted_ids). Partial misses and partial restrictions return 200. 422 VALIDATION_ERROR, 402 CREDITS_INSUFFICIENT.