{"openapi":"3.1.0","info":{"title":"Grizzly Bulls SEC Data API","version":"1.0.0","description":"Authenticated read API for retained SEC filing discovery, exact accession lookup, source-faithful Form 13F institutional holdings, extracted filing sections, observed 8-K item events, explicit filing-to-filing section diffs, canonical SEC-derived company financials, and commercially admitted current ownership including a reviewed Schedule 13 beneficial-ownership subset. Responses are served from retained/reviewed Grizzly Bulls state and never proxy customer requests to SEC.gov."},"servers":[{"url":"https://grizzlybulls.com/api/v1/sec"}],"security":[{"bearerAuth":[]}],"x-sec-api-version":"sec-api-v1","x-sec-plans":[{"id":"free","monthlyRequestLimit":1000,"requestsPerMinute":30,"maxPageSize":100}],"paths":{"/filings":{"get":{"operationId":"searchSecFilings","summary":"Search retained SEC filing metadata","parameters":[{"name":"form","in":"query","schema":{"type":"string","minLength":1,"maxLength":64},"description":"Exact normalized SEC form type, such as 8-K, 10-K, or DEF 14A."},{"name":"cik","in":"query","schema":{"type":"string","pattern":"^[0-9]{1,10}$"},"description":"Observed filer CIK from the SEC master index. This is not canonical company identity."},{"name":"filedFrom","in":"query","schema":{"type":"string","format":"date"}},{"name":"filedTo","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Filing page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingSearchResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/filings/{accessionNumber}":{"get":{"operationId":"getSecFiling","summary":"Get one retained SEC filing by accession number","parameters":[{"name":"accessionNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"}}],"responses":{"200":{"description":"Exact filing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/filings/{accessionNumber}/institutional-holdings":{"get":{"operationId":"listSec13fFilingHoldings","summary":"List source-faithful Form 13F holdings for one filing","description":"Returns normalized information-table rows retained for one exact 13F-HR or 13F-HR/A accession. Reported issuer names and CUSIPs remain filing observations; this route does not merge amendments or infer canonical company/security identity.","parameters":[{"name":"accessionNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Paginated source-faithful institutional holdings for the exact filing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstitutionalHoldingsResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/filings/{accessionNumber}/sections":{"get":{"operationId":"listSecFilingSections","summary":"List extracted sections and observed 8-K item events for one filing","parameters":[{"name":"accessionNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"}}],"responses":{"200":{"description":"Extracted filing section manifest.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingSectionsResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/filings/{accessionNumber}/sections/{sectionKey}":{"get":{"operationId":"getSecFilingSection","summary":"Get one normalized filing section","parameters":[{"name":"accessionNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"}},{"name":"sectionKey","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":80},"description":"Stable section key returned by the filing section manifest."}],"responses":{"200":{"description":"Normalized filing section text.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingSectionResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/filing-diff":{"get":{"operationId":"diffSecFilings","summary":"Compare extracted sections across two explicit SEC filings","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string"},"description":"Baseline SEC accession number."},{"name":"to","in":"query","required":true,"schema":{"type":"string"},"description":"Comparison SEC accession number."}],"responses":{"200":{"description":"Section-level filing diff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDiffResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/companies/{cik}/financials":{"get":{"operationId":"getSecCompanyFinancials","summary":"Get canonical SEC-derived company financials","description":"Returns reviewed canonical reported facts plus explicit derived metrics from the existing stock-platform fundamentals authority. Values are decimal strings. asOf reconstructs facts using conservative source-availability timing and never triggers an SEC request.","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,10}$"},"description":"Reviewed SEC issuer CIK."},{"name":"period","in":"query","schema":{"type":"string","enum":["all","annual","quarterly","ttm"],"default":"all"}},{"name":"metric","in":"query","schema":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]{0,63}$"},"description":"Optional exact canonical financial metric key."},{"name":"asOf","in":"query","schema":{"type":"string","format":"date-time"},"description":"Optional historical knowledge cutoff. Returned observations must have been source-available by this timestamp."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Maximum reported rows and maximum derived rows returned."}],"responses":{"200":{"description":"Canonical structured financials for one reviewed SEC issuer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyFinancialsResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/companies/{cik}/ownership":{"get":{"operationId":"getSecCompanyOwnership","summary":"Get commercially admitted company ownership","description":"Returns commercially admitted current Section 16-derived positions plus separately modeled Schedule 13 beneficial aggregates that passed reviewed issuer mapping, economic-composition, material-continuity, identity, and commercial-admission gates. This endpoint is not a complete beneficial-ownership register and does not convert filing-scoped Form 13F rows into company positions; use the exact-accession institutional-holdings route for source-faithful 13F data.","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,10}$"},"description":"Reviewed SEC issuer CIK."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Commercially admitted current and beneficial-ownership positions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyOwnershipResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your Grizzly Bulls API key as the Bearer token."}},"responses":{"InvalidRequest":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthenticated":{"description":"API key missing or invalid.","headers":{"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Filing not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimited":{"description":"Short-window or monthly limit exceeded.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}},"X-SEC-Quota-Limit":{"schema":{"type":"integer"}},"X-SEC-Quota-Remaining":{"schema":{"type":"integer"}},"X-SEC-Quota-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServiceUnavailable":{"description":"SEC API data or control plane temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ObservedFiler":{"type":"object","additionalProperties":false,"required":["cik","name"],"properties":{"cik":{"type":["string","null"],"pattern":"^[0-9]{10}$"},"name":{"type":["string","null"]}}},"Archive":{"type":"object","additionalProperties":false,"required":["archiveCik","sourcePath","completeSubmissionUrl"],"properties":{"archiveCik":{"type":["string","null"],"pattern":"^[0-9]{10}$"},"sourcePath":{"type":["string","null"]},"completeSubmissionUrl":{"type":["string","null"],"format":"uri"}}},"RetainedEvidence":{"type":["object","null"],"additionalProperties":false,"required":["evidenceId","documentName","mediaType","contentSha256","acquiredAt","resolverVersion","selectedAt"],"properties":{"evidenceId":{"type":"string"},"documentName":{"type":["string","null"]},"mediaType":{"type":["string","null"]},"contentSha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"acquiredAt":{"type":["string","null"],"format":"date-time"},"resolverVersion":{"type":["string","null"]},"selectedAt":{"type":["string","null"],"format":"date-time"}}},"Filing":{"type":"object","additionalProperties":false,"required":["accessionNumber","formType","filingDate","filingDirectoryUrl","firstDiscoveredAt","firstDiscoverySource","observedFiler","archive","retainedEvidence"],"properties":{"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"},"formType":{"type":"string"},"filingDate":{"type":"string","format":"date"},"filingDirectoryUrl":{"type":"string","format":"uri"},"firstDiscoveredAt":{"type":"string","format":"date-time"},"firstDiscoverySource":{"type":"string"},"observedFiler":{"$ref":"#/components/schemas/ObservedFiler"},"archive":{"$ref":"#/components/schemas/Archive"},"retainedEvidence":{"$ref":"#/components/schemas/RetainedEvidence"}}},"Meta":{"type":"object","additionalProperties":false,"required":["apiVersion","sourceAuthority","retrievedAt","semantics"],"properties":{"apiVersion":{"type":"string","const":"sec-api-v1"},"sourceAuthority":{"type":"string","const":"sec_source.filing_catalog"},"retrievedAt":{"type":"string","format":"date-time"},"semantics":{"type":"object","additionalProperties":false,"required":["observedFilerIsCanonicalIdentity","requestTimeSecFetch"],"properties":{"observedFilerIsCanonicalIdentity":{"type":"boolean","const":false},"requestTimeSecFetch":{"type":"boolean","const":false}}}}},"FilingSearchResponse":{"type":"object","additionalProperties":false,"required":["data","pagination","beneficialOwnershipPagination","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["filings"],"properties":{"filings":{"type":"array","items":{"$ref":"#/components/schemas/Filing"}}}},"pagination":{"type":"object","additionalProperties":false,"required":["limit","offset","returned","hasMore","nextOffset"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0,"maximum":10000},"returned":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"},"nextOffset":{"type":["integer","null"],"minimum":0}}},"meta":{"$ref":"#/components/schemas/Meta"}}},"FilingResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["filing"],"properties":{"filing":{"$ref":"#/components/schemas/Filing"}}},"meta":{"$ref":"#/components/schemas/Meta"}}},"FilingSectionMetadata":{"type":"object","additionalProperties":false,"required":["key","item","title","contentSha256","wordCount","normalizedStartLine","normalizedEndLine"],"properties":{"key":{"type":"string"},"item":{"type":"string"},"title":{"type":["string","null"]},"contentSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"wordCount":{"type":"integer","minimum":0},"normalizedStartLine":{"type":"integer","minimum":1},"normalizedEndLine":{"type":"integer","minimum":1}}},"FilingEvent":{"type":"object","additionalProperties":false,"required":["eventType","item","sectionKey","title","semanticInference"],"properties":{"eventType":{"type":"string","const":"8-k-item"},"item":{"type":"string"},"sectionKey":{"type":"string"},"title":{"type":["string","null"]},"semanticInference":{"type":"boolean","const":false}}},"FilingIntelligenceMeta":{"type":"object","additionalProperties":false,"required":["apiVersion","sourceAuthority","retrievedAt","semantics"],"properties":{"apiVersion":{"type":"string","const":"sec-api-v1"},"sourceAuthority":{"type":"string","const":"sec-filing-intelligence-v1"},"retrievedAt":{"type":"string","format":"date-time"},"semantics":{"type":"object","additionalProperties":false,"required":["requestTimeSecFetch","automaticAmendmentLinkage","eventSemanticInference"],"properties":{"requestTimeSecFetch":{"type":"boolean","const":false},"automaticAmendmentLinkage":{"type":"boolean","const":false},"eventSemanticInference":{"type":"boolean","const":false}}}}},"FilingIntelligenceManifest":{"type":"object","additionalProperties":false,"required":["schemaVersion","extractorVersion","accessionNumber","formType","baseFormType","filingDate","isAmendment","selectedDocument","sourceContentSha256","normalizedDocumentSha256","sections","events","semantics"],"properties":{"schemaVersion":{"type":"integer","const":1},"extractorVersion":{"type":"string","const":"sec-filing-intelligence-v1"},"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"},"formType":{"type":"string"},"baseFormType":{"type":"string","enum":["10-K","10-Q","8-K"]},"filingDate":{"type":"string","format":"date"},"isAmendment":{"type":"boolean"},"selectedDocument":{"type":"object","additionalProperties":false,"required":["documentType","sequence","filename","description"],"properties":{"documentType":{"type":"string"},"sequence":{"type":["integer","null"],"minimum":0},"filename":{"type":["string","null"]},"description":{"type":["string","null"]}}},"sourceContentSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"normalizedDocumentSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/FilingSectionMetadata"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/FilingEvent"}},"semantics":{"type":"object","additionalProperties":false,"required":["requestTimeSecFetch","automaticAmendmentLinkage","eventSemanticInference"],"properties":{"requestTimeSecFetch":{"type":"boolean","const":false},"automaticAmendmentLinkage":{"type":"boolean","const":false},"eventSemanticInference":{"type":"boolean","const":false}}}}},"FilingSectionsResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["filing"],"properties":{"filing":{"$ref":"#/components/schemas/FilingIntelligenceManifest"}}},"meta":{"$ref":"#/components/schemas/FilingIntelligenceMeta"}}},"FilingSectionResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["accessionNumber","section"],"properties":{"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"},"section":{"allOf":[{"$ref":"#/components/schemas/FilingSectionMetadata"},{"type":"object","required":["text"],"properties":{"text":{"type":"string"}}}]}}},"meta":{"$ref":"#/components/schemas/FilingIntelligenceMeta"}}},"FilingDiffResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["diff"],"properties":{"diff":{"type":"object","additionalProperties":false,"required":["schemaVersion","fromAccessionNumber","toAccessionNumber","baseFormType","sections","summary","semantics"],"properties":{"schemaVersion":{"type":"integer","const":1},"fromAccessionNumber":{"type":"string"},"toAccessionNumber":{"type":"string"},"baseFormType":{"type":"string","enum":["10-K","10-Q","8-K"]},"sections":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","item","status","fromContentSha256","toContentSha256","fromWordCount","toWordCount","wordCountDelta"],"properties":{"key":{"type":"string"},"item":{"type":"string"},"status":{"type":"string","enum":["added","removed","changed","unchanged"]},"fromContentSha256":{"type":["string","null"]},"toContentSha256":{"type":["string","null"]},"fromWordCount":{"type":["integer","null"]},"toWordCount":{"type":["integer","null"]},"wordCountDelta":{"type":["integer","null"]}}}},"summary":{"type":"object","additionalProperties":false,"required":["added","removed","changed","unchanged"],"properties":{"added":{"type":"integer","minimum":0},"removed":{"type":"integer","minimum":0},"changed":{"type":"integer","minimum":0},"unchanged":{"type":"integer","minimum":0}}},"semantics":{"type":"object","additionalProperties":false,"required":["comparedExplicitAccessions","automaticAmendmentLinkage"],"properties":{"comparedExplicitAccessions":{"type":"boolean","const":true},"automaticAmendmentLinkage":{"type":"boolean","const":false}}}}}}},"meta":{"$ref":"#/components/schemas/FilingIntelligenceMeta"}}},"FinancialReportedFact":{"type":"object","additionalProperties":false,"required":["factId","seriesKey","companyId","secIssuerCik","metricKey","statement","factKind","value","unit","currency","period","filing","xbrl","evidence","revision","directMethod"],"properties":{"factId":{"type":"string"},"seriesKey":{"type":"string"},"companyId":{"type":"string"},"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"},"metricKey":{"type":"string"},"statement":{"type":"string","enum":["income-statement","cash-flow","balance-sheet","capital-returns"]},"factKind":{"type":"string","enum":["duration","instant"]},"value":{"type":"string","pattern":"^-?[0-9]+(?:\\.[0-9]+)?$"},"unit":{"type":"string"},"currency":{"type":["string","null"]},"period":{"type":"object","additionalProperties":false,"required":["periodId","kind","startDate","endDate","fiscalYearLabel","fiscalPeriodLabel"],"properties":{"periodId":{"type":"string"},"kind":{"type":"string","enum":["fiscal-year","fiscal-quarter","fiscal-ytd","instant"]},"startDate":{"type":["string","null"],"format":"date"},"endDate":{"type":"string","format":"date"},"fiscalYearLabel":{"type":["string","null"]},"fiscalPeriodLabel":{"type":["string","null"]}}},"filing":{"type":"object","additionalProperties":false,"required":["accession","form","filedAt","availableAt","filingFiscalYear","frame"],"properties":{"accession":{"type":"string"},"form":{"type":"string"},"filedAt":{"type":"string","format":"date"},"availableAt":{"type":"string","format":"date-time"},"filingFiscalYear":{"type":["integer","null"]},"frame":{"type":["string","null"]}}},"xbrl":{"type":"object","additionalProperties":false,"required":["concept","sourceFactLocator"],"properties":{"concept":{"type":"string"},"sourceFactLocator":{"type":"string"}}},"evidence":{"type":"object","additionalProperties":false,"required":["evidenceId","sourceId","sourceRecordId","contentSha256","acquiredAt","sourcePublishedAt","rightsProfileId"],"properties":{"evidenceId":{"type":"string"},"sourceId":{"type":"string"},"sourceRecordId":{"type":"string"},"contentSha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"acquiredAt":{"type":"string","format":"date-time"},"sourcePublishedAt":{"type":["string","null"],"format":"date-time"},"rightsProfileId":{"type":"string"}}},"revision":{"type":"object","additionalProperties":false,"required":["number","supersedesFactId","currentlySelected","currentState"],"properties":{"number":{"type":"integer","minimum":1},"supersedesFactId":{"type":["string","null"]},"currentlySelected":{"type":"boolean"},"currentState":{"type":"string","enum":["active","superseded"]}}},"directMethod":{"type":"string"}}},"FinancialDerivedInput":{"type":"object","additionalProperties":false,"required":["inputRecordId","ordinal","role","sourceFactLocator","evidenceId","value","unit","concept","periodStart","periodEnd","filedAt","form"],"properties":{"inputRecordId":{"type":"string"},"ordinal":{"type":"integer","minimum":0},"role":{"type":"string"},"sourceFactLocator":{"type":"string"},"evidenceId":{"type":"string"},"value":{"type":["string","null"],"pattern":"^-?[0-9]+(?:\\.[0-9]+)?$"},"unit":{"type":["string","null"]},"concept":{"type":["string","null"]},"periodStart":{"type":["string","null"],"format":"date"},"periodEnd":{"type":["string","null"],"format":"date"},"filedAt":{"type":["string","null"],"format":"date"},"form":{"type":["string","null"]}}},"FinancialDerivedMetric":{"type":"object","additionalProperties":false,"required":["metricObservationId","companyId","metricKey","value","unit","asOfDate","availableAt","computedAt","methodology","rightsProfileId","currentlySelected","inputs"],"properties":{"metricObservationId":{"type":"string"},"companyId":{"type":"string"},"metricKey":{"type":"string"},"value":{"type":"string","pattern":"^-?[0-9]+(?:\\.[0-9]+)?$"},"unit":{"type":"string"},"asOfDate":{"type":"string","format":"date"},"availableAt":{"type":"string","format":"date-time"},"computedAt":{"type":"string","format":"date-time"},"methodology":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"type":"string"},"version":{"type":"string"}}},"rightsProfileId":{"type":"string"},"currentlySelected":{"type":"boolean"},"inputs":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/FinancialDerivedInput"}}}},"CompanyFinancialsResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["company","reportedFacts","derivedMetrics"],"properties":{"company":{"type":"object","additionalProperties":false,"required":["companyId","secIssuerCik"],"properties":{"companyId":{"type":"string"},"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"}}},"reportedFacts":{"type":"array","items":{"$ref":"#/components/schemas/FinancialReportedFact"}},"derivedMetrics":{"type":"array","items":{"$ref":"#/components/schemas/FinancialDerivedMetric"}}}},"meta":{"type":"object","additionalProperties":false,"required":["apiVersion","sourceAuthority","retrievedAt","query","semantics"],"properties":{"apiVersion":{"type":"string","const":"sec-api-v1"},"sourceAuthority":{"type":"string","const":"stock_canonical.fundamental_facts+derived_metrics"},"retrievedAt":{"type":"string","format":"date-time"},"query":{"type":"object","additionalProperties":false,"required":["secIssuerCik","periodScope","metricKey","asOf","limit"],"properties":{"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"},"periodScope":{"type":"string","enum":["all","annual","quarterly","ttm"]},"metricKey":{"type":["string","null"]},"asOf":{"type":["string","null"],"format":"date-time"},"limit":{"type":"integer","minimum":1,"maximum":100}}},"semantics":{"type":"object","additionalProperties":false,"required":["requestTimeSecFetch","canonicalCompanyIdentity","valuesAreDecimalStrings","pointInTimeMode","conservativeFilingAvailability","reportedFactRevisionChains","derivedMetricsAreSourceReported","derivedMetricsCarryExplicitInputs"],"properties":{"requestTimeSecFetch":{"type":"boolean","const":false},"canonicalCompanyIdentity":{"type":"boolean","const":true},"valuesAreDecimalStrings":{"type":"boolean","const":true},"pointInTimeMode":{"type":"string","enum":["current-selection","source-available-as-of"]},"conservativeFilingAvailability":{"type":"boolean","const":true},"reportedFactRevisionChains":{"type":"boolean","const":true},"derivedMetricsAreSourceReported":{"type":"boolean","const":false},"derivedMetricsCarryExplicitInputs":{"type":"boolean","const":true}}}}}}},"CompanyOwnershipSource":{"type":"object","additionalProperties":false,"required":["sourceId","canonicalSourceId","publisher","title","locator","publishedAt"],"properties":{"sourceId":{"type":"string"},"canonicalSourceId":{"type":"string"},"publisher":{"type":"string"},"title":{"type":"string"},"locator":{"type":"object","additionalProperties":false,"required":["kind","value"],"properties":{"kind":{"type":"string","enum":["sec-accession","url","unavailable"]},"value":{"type":["string","null"]}}},"publishedAt":{"type":["string","null"]}}},"InstitutionalHolding13f":{"type":"object","additionalProperties":false,"required":["sourceOrdinal","nameOfIssuer","titleOfClass","cusip","reportedValueThousandsUsd","reportedAmount","reportedAmountType","putCall","investmentDiscretion","otherManager","votingAuthority"],"properties":{"sourceOrdinal":{"type":"integer","minimum":0},"nameOfIssuer":{"type":"string"},"titleOfClass":{"type":"string"},"cusip":{"type":"string","pattern":"^[A-Z0-9]{9}$"},"reportedValueThousandsUsd":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"reportedAmount":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"reportedAmountType":{"type":"string","enum":["SH","PRN"]},"putCall":{"type":["string","null"],"enum":["PUT","CALL",null]},"investmentDiscretion":{"type":"string"},"otherManager":{"type":["string","null"]},"votingAuthority":{"type":"object","additionalProperties":false,"required":["sole","shared","none"],"properties":{"sole":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"shared":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"none":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}}}}},"InstitutionalHoldingsResponse":{"type":"object","additionalProperties":false,"required":["data","pagination","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["filing","holdings"],"properties":{"filing":{"type":"object","additionalProperties":false,"required":["accessionNumber","formType","filingDate","reportPeriod","manager"],"properties":{"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"},"formType":{"type":"string","enum":["13F-HR","13F-HR/A"]},"filingDate":{"type":"string","format":"date"},"reportPeriod":{"type":"string","format":"date"},"manager":{"type":"object","additionalProperties":false,"required":["observedCik","observedName","identityAuthority"],"properties":{"observedCik":{"type":"string","pattern":"^[0-9]{10}$"},"observedName":{"type":"string"},"identityAuthority":{"type":"string","const":"sec-filing-header-observation"}}}}},"holdings":{"type":"array","items":{"$ref":"#/components/schemas/InstitutionalHolding13f"}}}},"pagination":{"type":"object","additionalProperties":false,"required":["limit","offset","returned","total","hasMore","nextOffset"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0,"maximum":10000},"returned":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"},"nextOffset":{"type":["integer","null"],"minimum":0}}},"meta":{"type":"object","additionalProperties":false,"required":["apiVersion","sourceAuthority","retrievedAt","sourceContentSha256","holdingsContentSha256","semantics"],"properties":{"apiVersion":{"type":"string","const":"sec-api-v1"},"sourceAuthority":{"type":"string","const":"sec-13f-institutional-holdings-v1"},"retrievedAt":{"type":"string","format":"date-time"},"sourceContentSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"holdingsContentSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"semantics":{"type":"object","additionalProperties":false,"required":["requestTimeSecFetch","exactAccessionScoped","automaticAmendmentMerge","managerIdentityCanonicalized","issuerNamesAreReportedLabels","cusipIsCanonicalSecurityIdentity","companyResolutionApplied","reportedValueUnit"],"properties":{"requestTimeSecFetch":{"type":"boolean","const":false},"exactAccessionScoped":{"type":"boolean","const":true},"automaticAmendmentMerge":{"type":"boolean","const":false},"managerIdentityCanonicalized":{"type":"boolean","const":false},"issuerNamesAreReportedLabels":{"type":"boolean","const":true},"cusipIsCanonicalSecurityIdentity":{"type":"boolean","const":false},"companyResolutionApplied":{"type":"boolean","const":false},"reportedValueUnit":{"type":"string","const":"thousands-usd"}}}}}}},"CompanyOwnershipPosition":{"type":"object","additionalProperties":false,"required":["owner","company","security","position","filing","version","sources"],"properties":{"owner":{"type":"object","additionalProperties":false,"required":["personId","name","reportingOwnerCik"],"properties":{"personId":{"type":"string"},"name":{"type":"string"},"reportingOwnerCik":{"type":"string","pattern":"^[0-9]{10}$"}}},"company":{"type":"object","additionalProperties":false,"required":["companyId","name","secIssuerCik"],"properties":{"companyId":{"type":"string"},"name":{"type":"string"},"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"}}},"security":{"type":"object","additionalProperties":false,"required":["legalSecurityId","name","instrumentFamily","ticker","exchange"],"properties":{"legalSecurityId":{"type":"string"},"name":{"type":"string"},"instrumentFamily":{"type":"string"},"ticker":{"type":["string","null"]},"exchange":{"type":["string","null"]}}},"position":{"type":"object","additionalProperties":false,"required":["ownershipKind","relationshipState","currentBasisUnits","reportedUnits","reportedAsOfDate","valuationAsOfDate","currentValueUsd"],"properties":{"ownershipKind":{"type":"string"},"relationshipState":{"type":"string"},"currentBasisUnits":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"reportedUnits":{"type":["string","null"],"pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"reportedAsOfDate":{"type":"string","format":"date"},"valuationAsOfDate":{"type":"string","format":"date"},"currentValueUsd":{"type":["number","null"],"minimum":0}}},"filing":{"type":"object","additionalProperties":false,"required":["accessionNumber","form","filingDate","effectiveDate"],"properties":{"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"},"form":{"type":"string"},"filingDate":{"type":"string","format":"date"},"effectiveDate":{"type":"string","format":"date"}}},"version":{"type":"object","additionalProperties":false,"required":["versionId","knowledgeRecordedAt","knowledgeValidFrom","knowledgeValidThrough"],"properties":{"versionId":{"type":"string"},"knowledgeRecordedAt":{"type":"string","format":"date-time"},"knowledgeValidFrom":{"type":"string","format":"date-time"},"knowledgeValidThrough":{"type":["string","null"],"format":"date-time"}}},"sources":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/CompanyOwnershipSource"}}}},"CompanyBeneficialOwnershipPosition":{"type":"object","additionalProperties":false,"required":["owner","company","security","position","materialContinuity","filing","version","sources"],"properties":{"owner":{"type":"object","additionalProperties":false,"required":["personId","name"],"properties":{"personId":{"type":"string"},"name":{"type":"string"}}},"company":{"type":"object","additionalProperties":false,"required":["companyId","name","secIssuerCik"],"properties":{"companyId":{"type":"string"},"name":{"type":"string"},"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"}}},"security":{"type":"object","additionalProperties":false,"required":["legalSecurityId","name","securityType","ticker","exchange"],"properties":{"legalSecurityId":{"type":"string"},"name":{"type":"string"},"securityType":{"type":"string"},"ticker":{"type":["string","null"]},"exchange":{"type":["string","null"]}}},"position":{"type":"object","additionalProperties":false,"required":["ownershipKind","relationshipState","reportedShares","reportedAsOfDate","valuationTreatment"],"properties":{"ownershipKind":{"type":"string","const":"beneficial-aggregate"},"relationshipState":{"type":"string"},"reportedShares":{"type":"string","pattern":"^[0-9]+$"},"reportedAsOfDate":{"type":"string","format":"date"},"valuationTreatment":{"type":"string"}}},"materialContinuity":{"type":"object","additionalProperties":false,"required":["methodologyVersion","throughDate","exactShareCountReobserved"],"properties":{"methodologyVersion":{"type":"string","const":"schedule13-material-continuity-v1"},"throughDate":{"type":"string","format":"date"},"exactShareCountReobserved":{"type":"boolean","const":false}}},"filing":{"type":"object","additionalProperties":false,"required":["accessionNumber"],"properties":{"accessionNumber":{"type":"string","pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$"}}},"version":{"type":"object","additionalProperties":false,"required":["versionId","knowledgeRecordedAt","knowledgeValidFrom","knowledgeValidThrough"],"properties":{"versionId":{"type":"string"},"knowledgeRecordedAt":{"type":"string","format":"date-time"},"knowledgeValidFrom":{"type":"string","format":"date-time"},"knowledgeValidThrough":{"type":["string","null"],"format":"date-time"}}},"sources":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/CompanyOwnershipSource"}}}},"CompanyOwnershipResponse":{"type":"object","additionalProperties":false,"required":["data","pagination","beneficialOwnershipPagination","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["company","positions","beneficialOwnershipPositions"],"properties":{"company":{"type":"object","additionalProperties":false,"required":["companyId","name","secIssuerCik"],"properties":{"companyId":{"type":"string"},"name":{"type":"string"},"secIssuerCik":{"type":"string","pattern":"^[0-9]{10}$"}}},"positions":{"type":"array","items":{"$ref":"#/components/schemas/CompanyOwnershipPosition"}},"beneficialOwnershipPositions":{"type":"array","items":{"$ref":"#/components/schemas/CompanyBeneficialOwnershipPosition"}}}},"pagination":{"type":"object","additionalProperties":false,"required":["limit","returned","total","hasMore"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"returned":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}}},"beneficialOwnershipPagination":{"type":"object","additionalProperties":false,"required":["limit","returned","total","hasMore"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"returned":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}}},"meta":{"type":"object","additionalProperties":false,"required":["apiVersion","sourceAuthority","knowledgeAsOf","effectiveAsOf","payloadSha256","coverage","semantics"],"properties":{"apiVersion":{"type":"string","const":"sec-api-v1"},"sourceAuthority":{"type":"string","const":"wealth-commercial-extracted-facts:siw+bb-schedule13"},"knowledgeAsOf":{"type":"string","format":"date-time"},"effectiveAsOf":{"type":["string","null"],"format":"date-time"},"payloadSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"coverage":{"type":"object","additionalProperties":false,"required":["section16CurrentDisclosedPositions","schedule13BeneficialOwnership","institutional13fHoldings"],"properties":{"section16CurrentDisclosedPositions":{"type":"string","const":"commercially-admitted-subset"},"schedule13BeneficialOwnership":{"type":"string","const":"commercially-admitted-subset"},"institutional13fHoldings":{"type":"string","const":"unsupported"}}},"semantics":{"type":"object","additionalProperties":false,"required":["requestTimeSecFetch","commercialAdmissionRequired","unresolvedPersonIdentityExcluded","currentPositionsOnly","completeBeneficialOwnership","schedule13Included","institutionalHoldingsIncluded"],"properties":{"requestTimeSecFetch":{"type":"boolean","const":false},"commercialAdmissionRequired":{"type":"boolean","const":true},"unresolvedPersonIdentityExcluded":{"type":"boolean","const":true},"currentPositionsOnly":{"type":"boolean","const":true},"completeBeneficialOwnership":{"type":"boolean","const":false},"schedule13Included":{"type":"boolean","const":true},"institutionalHoldingsIncluded":{"type":"boolean","const":false}}}}}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","method_not_allowed","unauthenticated","rate_limited","not_found","service_unavailable","internal_error"]},"message":{"type":"string"}}}}}}}}