Skip to content
/api/v1/ownership/beneficial-ownership/filings/{accession}

Get full detail for a single beneficial ownership filing.

Get full detail for a single beneficial ownership filing.

10 tokensSince v3.0.0

Why use this

Drill into the full structured payload of a single Schedule 13D/13G filing once you've identified the accession via `/ownership/beneficial-ownership/filings`. Returns the complete amendment-chain context: all filers (joint filings can have 2-9+ entities), per-filer position rows with separated voting/dispositive power, classified purpose with NLP-extracted intent flags (`intends_to_acquire`, `opposes_management`, `seeks_board_seats`, `intends_proxy_fight`), Schedule 13D group memberships, parsed exhibits with URLs, and per-filer footnotes. The right endpoint for activist-thesis research, M&A-related ownership disclosure analysis, and compliance / KYC due-diligence on filers.

Common use case

Deep-dive into a specific 13D/13G filing to understand ownership structure, intent, and exhibits.

Full detail of a single 13D/13G filing — all filers, all positions, classified purpose with intent flags, group memberships, footnotes, exhibits. Use after locating an accession via GET /api/v1/ownership/beneficial-ownership/filings.

Parameters

NameInRequiredDefaultAllowedDescriptionExample
accessionpathrequired——SEC accession number — accepts both canonical dashed form (`0001193125-22-104916`) and undashed form (`000119312522104916`). Server normalizes both. Returns 404 when the accession is not a 13D/13G/13D-A/13G-A filing in our parser cache (other form types return Form 4 / 13F detail via their respective endpoints).0001193125-22-104916

Response schema

FieldTypeNullableDescription
accessionNumberstringnoSEC accession echoed back in canonical dashed form regardless of input casing.
formTypestringnoSchedule form type — one of `13D`, `13G`, `13D/A`, `13G/A`. The `/A` suffix preserved verbatim. 13D filings carry materially higher signal than 13G — they require disclosing INTENT, not just OWNERSHIP.
filedAtstringnoISO-8601 UTC timestamp of SEC EDGAR acceptance. The 10-day filing-window deadline (for 13Ds) is computed from the trigger event date in the filing body, NOT from this `filedAt`.
issuerobjectnoIssuer block: `{ cik: string (10-char zero-padded), ticker: string|null, name: string }`. The company being reported on. `ticker` may be null for private-issuer filings (M&A targets) or foreign-issuer filings without ADRs.
filersarraynoArray of all reporting persons on this filing — one entry per filer. Joint filings (Schedule 13D groups, family-office layered structures) have 2-9+ entries. Each entry: `{ cik, name, percentOfClass, sharesOwned, isOfficer, isDirector, signatureRole, address }`. Use `cik` as the stable join key against `/ownership/beneficial-ownership/filers/{cik}/portfolio`.
positionsarraynoArray of position rows — typically one per filer (so length matches `filers[]`). Each entry exposes the SEC-mandated voting + dispositive-power decomposition: `{ filerCik, percentOfClass, sharesOwned, soleVotingPower, sharedVotingPower, soleDispositivePower, sharedDispositivePower, votingPower, dispositivePower }`. Critical for compliance — `sharedVotingPower` indicates a different control regime than `soleVotingPower`.
purposeobjectyesClassified purpose-of-transaction (Item 4) extracted via rule-based NLP. Shape: `{ primary: string, flags: { intends_to_acquire, opposes_management, seeks_board_seats, intends_proxy_fight, intends_tender_offer, intends_going_private, intends_recapitalization, ... } }`. `primary` enumerated as `passive`, `activist`, `m&a`, `going-private`, `proxy-fight`, `recapitalization`, `block-trade`, `unspecified`. Null on legacy pre-classification filings.
groupMembersarrayyesArray of co-filer entities when this filing is part of a Schedule 13D group (an explicit cooperation pact for accumulating > 5%). Each entry: `{ cik, name, isLeadFiler }`. Null when not a group filing (most are single-filer).
exhibitsarrayyesExhibits attached to the filing — array of `{ type, url, description }` (e.g. shareholder agreements, joint-filing agreements, settlement deeds, demand letters). Activist filings often have multi-page exhibits (Carl Icahn's letters to boards routinely run 5-10 pages). Null when filing has no exhibits.
footnotesarrayyesPer-filer footnotes parsed from the filing's notes section — array of `{ filerCik, footnote }`. Footnotes typically clarify the nature of indirect ownership (trust, LP, family office vehicle) or split-credit attribution. Null when filing has no footnotes.

Sample response

·
  • "accessionNumber": "0001193125-26-001234"
  • "formType": "13D"
  • "filedAt": "2026-04-15T20:14:32.000Z"
  • "issuer":
    • "cik": "0000320193"
    • "ticker": "AAPL"
    • "name": "APPLE INC"
    }
  • "filers":
    ]
  • "positions":
    ]
  • "purpose":
    • "primary": "passive"
    • "flags":
    }
}

Errors

StatusLabelDescription
200OKRequest succeeded.
400Bad RequestInvalid query, body, or path parameter.
401UnauthorizedMissing or invalid Authorization header / api_Token.
402Payment RequiredInsufficient token balance for this call. Top up
429Too Many RequestsRate limit exceeded for your tier (see /pricing for tier limits). Tier limits
500Server ErrorUnexpected server-side failure. Retry with backoff; report if persistent.

Code samples

curl "https://api.finradar.ai/api/v1/ownership/beneficial-ownership/filings/{accession}?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).

Try it

Related endpoints

/api/v1/ownership/beneficial-ownership/filings10 tokens/api/v1/ownership/beneficial-ownership/issuers/{cik}/summary10 tokens/api/v1/ownership/beneficial-ownership/groups10 tokens/api/v1/ownership/beneficial-ownership/conversions10 tokens