{"openapi":"3.1.0","info":{"title":"Grizzly Bulls Wealth Intelligence API","version":"1.2.0","description":"Versioned evidence-backed wealth intelligence API. Responses are built only from records that pass Grizzly Bulls commercial extracted-fact rights review. Authentication, account entitlement, request quotas and dataset licensing eligibility are independent gates."},"servers":[{"url":"https://api.grizzlybulls.com/v1"}],"security":[{"WealthApiKey":[]}],"x-wealth-api-version":"wealth-api-v1","x-wealth-plans":[{"id":"free","monthlyRequestLimit":200,"dailyRequestLimit":10,"requestsPerMinute":10,"maxHistoryPageSize":25},{"id":"developer","monthlyRequestLimit":25000,"dailyRequestLimit":null,"requestsPerMinute":120,"maxHistoryPageSize":50},{"id":"business","monthlyRequestLimit":250000,"dailyRequestLimit":null,"requestsPerMinute":600,"maxHistoryPageSize":200},{"id":"enterprise","monthlyRequestLimit":2000000,"dailyRequestLimit":null,"requestsPerMinute":1200,"maxHistoryPageSize":500}],"paths":{"/wealth/people":{"get":{"operationId":"searchWealthPeople","summary":"Find commercially available Wealth API people by name or canonical ID","parameters":[{"name":"query","in":"query","required":true,"description":"Case-insensitive name or canonical person ID search. Matching is deterministic and does not create or infer identity.","schema":{"type":"string","minLength":2,"maxLength":100,"example":"martine rothblatt"}},{"name":"limit","in":"query","required":false,"description":"Maximum matching people returned.","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Commercially eligible people matching the requested name or canonical ID.","headers":{"X-Wealth-Plan":{"description":"Resolved Wealth API plan for the authenticated account.","schema":{"type":"string","enum":["free","developer","business","enterprise"]}},"X-Wealth-Rate-Limit":{"description":"Maximum requests permitted per minute for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-History-Page-Limit":{"description":"Maximum history records permitted per page for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1,"maximum":500}},"X-Wealth-Quota-Limit":{"description":"Monthly Wealth API request quota for the resolved plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-Quota-Remaining":{"description":"Monthly Wealth API requests remaining after the current operation was reserved.","schema":{"type":"integer","minimum":0}},"X-Wealth-Quota-Reset":{"description":"UTC timestamp when the current monthly quota window resets.","schema":{"type":"string","format":"date-time"}},"X-Wealth-Daily-Quota-Limit":{"description":"Daily request quota when the resolved Wealth API plan has one.","schema":{"type":"integer","minimum":1}},"X-Wealth-Daily-Quota-Remaining":{"description":"Daily requests remaining after the current operation was reserved, when applicable.","schema":{"type":"integer","minimum":0}},"X-Wealth-Daily-Quota-Reset":{"description":"UTC timestamp when the current daily quota window resets, when applicable.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeopleSearchResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/wealth/people/{personId}":{"get":{"operationId":"getWealthPerson","summary":"Get commercially available current wealth intelligence for a person","parameters":[{"name":"personId","in":"path","required":true,"description":"Canonical Grizzly Bulls Wealth person ID without the person: graph-key prefix.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","example":"jensen-huang"}}],"responses":{"200":{"description":"Current commercially eligible person and wealth resources.","headers":{"X-Wealth-Plan":{"description":"Resolved Wealth API plan for the authenticated account.","schema":{"type":"string","enum":["free","developer","business","enterprise"]}},"X-Wealth-Rate-Limit":{"description":"Maximum requests permitted per minute for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-History-Page-Limit":{"description":"Maximum history records permitted per page for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1,"maximum":500}},"X-Wealth-Quota-Limit":{"description":"Monthly Wealth API request quota for the resolved plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-Quota-Remaining":{"description":"Monthly Wealth API requests remaining after the current operation was reserved.","schema":{"type":"integer","minimum":0}},"X-Wealth-Quota-Reset":{"description":"UTC timestamp when the current monthly quota window resets.","schema":{"type":"string","format":"date-time"}},"X-Wealth-Daily-Quota-Limit":{"description":"Daily request quota when the resolved Wealth API plan has one.","schema":{"type":"integer","minimum":1}},"X-Wealth-Daily-Quota-Remaining":{"description":"Daily requests remaining after the current operation was reserved, when applicable.","schema":{"type":"integer","minimum":0}},"X-Wealth-Daily-Quota-Reset":{"description":"UTC timestamp when the current daily quota window resets, when applicable.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/wealth/people/{personId}/ownership":{"get":{"operationId":"getWealthPersonOwnership","summary":"Get commercially available current ownership positions for a person","parameters":[{"name":"personId","in":"path","required":true,"description":"Canonical Grizzly Bulls Wealth person ID without the person: graph-key prefix.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","example":"jensen-huang"}}],"responses":{"200":{"description":"Current commercially eligible ownership positions.","headers":{"X-Wealth-Plan":{"description":"Resolved Wealth API plan for the authenticated account.","schema":{"type":"string","enum":["free","developer","business","enterprise"]}},"X-Wealth-Rate-Limit":{"description":"Maximum requests permitted per minute for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-History-Page-Limit":{"description":"Maximum history records permitted per page for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1,"maximum":500}},"X-Wealth-Quota-Limit":{"description":"Monthly Wealth API request quota for the resolved plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-Quota-Remaining":{"description":"Monthly Wealth API requests remaining after the current operation was reserved.","schema":{"type":"integer","minimum":0}},"X-Wealth-Quota-Reset":{"description":"UTC timestamp when the current monthly quota window resets.","schema":{"type":"string","format":"date-time"}},"X-Wealth-Daily-Quota-Limit":{"description":"Daily request quota when the resolved Wealth API plan has one.","schema":{"type":"integer","minimum":1}},"X-Wealth-Daily-Quota-Remaining":{"description":"Daily requests remaining after the current operation was reserved, when applicable.","schema":{"type":"integer","minimum":0}},"X-Wealth-Daily-Quota-Reset":{"description":"UTC timestamp when the current daily quota window resets, when applicable.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnershipResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/wealth/people/{personId}/history":{"get":{"operationId":"getWealthPersonHistory","summary":"Get commercially available retained wealth history for a person","parameters":[{"name":"personId","in":"path","required":true,"description":"Canonical Grizzly Bulls Wealth person ID without the person: graph-key prefix.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","example":"jensen-huang"}},{"name":"limit","in":"query","required":false,"description":"Maximum records returned. The authenticated plan may impose a lower maximum.","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"offset","in":"query","required":false,"description":"Zero-based history offset.","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Commercially eligible retained wealth history.","headers":{"X-Wealth-Plan":{"description":"Resolved Wealth API plan for the authenticated account.","schema":{"type":"string","enum":["free","developer","business","enterprise"]}},"X-Wealth-Rate-Limit":{"description":"Maximum requests permitted per minute for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-History-Page-Limit":{"description":"Maximum history records permitted per page for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1,"maximum":500}},"X-Wealth-Quota-Limit":{"description":"Monthly Wealth API request quota for the resolved plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-Quota-Remaining":{"description":"Monthly Wealth API requests remaining after the current operation was reserved.","schema":{"type":"integer","minimum":0}},"X-Wealth-Quota-Reset":{"description":"UTC timestamp when the current monthly quota window resets.","schema":{"type":"string","format":"date-time"}},"X-Wealth-Daily-Quota-Limit":{"description":"Daily request quota when the resolved Wealth API plan has one.","schema":{"type":"integer","minimum":1}},"X-Wealth-Daily-Quota-Remaining":{"description":"Daily requests remaining after the current operation was reserved, when applicable.","schema":{"type":"integer","minimum":0}},"X-Wealth-Daily-Quota-Reset":{"description":"UTC timestamp when the current daily quota window resets, when applicable.","schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}},"components":{"securitySchemes":{"WealthApiKey":{"type":"http","scheme":"bearer","bearerFormat":"Grizzly Bulls API key","description":"Send a Grizzly Bulls API key using Authorization: Bearer <api-key>. Wealth API access also requires an explicit active account.wealthApi entitlement."}},"responses":{"InvalidRequest":{"description":"The search query, person ID or pagination parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"A valid Grizzly Bulls API key is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"The authenticated account does not have an active Wealth API entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"No commercially eligible Wealth API resource was found, or the API is not externally enabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"MethodNotAllowed":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimited":{"description":"The short-window request rate or monthly Wealth API quota was exceeded.","headers":{"X-Wealth-Plan":{"description":"Resolved Wealth API plan for the authenticated account.","schema":{"type":"string","enum":["free","developer","business","enterprise"]}},"X-Wealth-Rate-Limit":{"description":"Maximum requests permitted per minute for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-History-Page-Limit":{"description":"Maximum history records permitted per page for the resolved Wealth API plan.","schema":{"type":"integer","minimum":1,"maximum":500}},"X-Wealth-Quota-Limit":{"description":"Monthly Wealth API request quota for the resolved plan.","schema":{"type":"integer","minimum":1}},"X-Wealth-Quota-Remaining":{"description":"Monthly Wealth API requests remaining after the current operation was reserved.","schema":{"type":"integer","minimum":0}},"X-Wealth-Quota-Reset":{"description":"UTC timestamp when the current monthly quota window resets.","schema":{"type":"string","format":"date-time"}},"X-Wealth-Daily-Quota-Limit":{"description":"Daily request quota when the resolved Wealth API plan has one.","schema":{"type":"integer","minimum":1}},"X-Wealth-Daily-Quota-Remaining":{"description":"Daily requests remaining after the current operation was reserved, when applicable.","schema":{"type":"integer","minimum":0}},"X-Wealth-Daily-Quota-Reset":{"description":"UTC timestamp when the current daily quota window resets, when applicable.","schema":{"type":"string","format":"date-time"}},"Retry-After":{"description":"Seconds until the request may be retried.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalError":{"description":"The request failed without exposing internal implementation details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServiceUnavailable":{"description":"Authentication, usage metering or the pinned rights-filtered Wealth dataset is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"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","forbidden","rate_limited","not_found","service_unavailable","internal_error"]},"message":{"type":"string"}}}}},"Person":{"type":"object","additionalProperties":false,"required":["id","graphKey","label"],"properties":{"id":{"type":"string"},"graphKey":{"type":"string","pattern":"^person:"},"label":{"type":"string"}}},"Source":{"type":"object","additionalProperties":false,"required":["sourceId","publisher","title","locator","publishedAt"],"properties":{"sourceId":{"type":"string"},"publisher":{"type":"string"},"title":{"type":"string"},"locator":{"type":"object","additionalProperties":false,"required":["kind","value"],"properties":{"kind":{"type":"string","enum":["url","sec-accession","unavailable"]},"value":{"type":["string","null"]}}},"publishedAt":{"type":["string","null"]}}},"Version":{"type":"object","additionalProperties":false,"required":["versionId","lineageId","knowledgeRecordedAt","knowledgeValidFrom","knowledgeValidThrough","changeKind"],"properties":{"versionId":{"type":"string"},"lineageId":{"type":"string"},"knowledgeRecordedAt":{"type":"string"},"knowledgeValidFrom":{"type":"string"},"knowledgeValidThrough":{"type":["string","null"]},"changeKind":{"type":"string","enum":["initial","update","correction","supersession"]}}},"Scenario":{"type":"object","additionalProperties":false,"required":["bear","base","bull"],"properties":{"bear":{"type":["number","null"]},"base":{"type":["number","null"]},"bull":{"type":["number","null"]}}},"Ownership":{"type":"object","additionalProperties":false,"required":["kind","recordId","ownerId","ownedAsset","ownershipKind","relationshipState","percentage","quantity","effectiveAt","version","sources"],"properties":{"kind":{"type":"string","const":"ownership"},"recordId":{"type":"string"},"ownerId":{"type":"string"},"ownedAsset":{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"type":"string","enum":["organization","security","asset"]},"id":{"type":"string"}}},"ownershipKind":{"type":"string"},"relationshipState":{"type":"string"},"percentage":{"type":["number","null"]},"quantity":{"type":["object","null"]},"effectiveAt":{"type":["string","null"]},"version":{"$ref":"#/components/schemas/Version"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"WealthEstimate":{"type":"object","additionalProperties":false,"required":["kind","recordId","estimateKind","scenario","currency","confidence","methodologyVersion","effectiveAt","version","sources"],"properties":{"kind":{"type":"string","const":"wealth-estimate"},"recordId":{"type":"string"},"estimateKind":{"type":"string"},"scenario":{"$ref":"#/components/schemas/Scenario"},"currency":{"type":"string"},"confidence":{"type":["number","null"]},"methodologyVersion":{"type":"string"},"effectiveAt":{"type":["string","null"]},"version":{"$ref":"#/components/schemas/Version"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"WealthComponent":{"type":"object","additionalProperties":false,"required":["kind","recordId","componentKind","assetClass","objectId","scenario","currency","valuationMethod","effectiveAt","version","sources"],"properties":{"kind":{"type":"string","const":"wealth-component"},"recordId":{"type":"string"},"componentKind":{"type":"string"},"assetClass":{"type":"string"},"objectId":{"type":["string","null"]},"scenario":{"$ref":"#/components/schemas/Scenario"},"currency":{"type":"string"},"valuationMethod":{"type":["string","null"]},"effectiveAt":{"type":["string","null"]},"version":{"$ref":"#/components/schemas/Version"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"Valuation":{"type":"object","additionalProperties":false,"required":["kind","recordId","objectId","value","currency","valuationMethod","effectiveAt","version","sources"],"properties":{"kind":{"type":"string","const":"valuation"},"recordId":{"type":"string"},"objectId":{"type":"string"},"value":{"type":["number","string"]},"currency":{"type":"string"},"valuationMethod":{"type":["string","null"]},"effectiveAt":{"type":["string","null"]},"version":{"$ref":"#/components/schemas/Version"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"FinancialEvent":{"type":"object","additionalProperties":false,"required":["kind","recordId","eventType","balanceSheetRole","measures","effectiveAt","version","sources"],"properties":{"kind":{"type":"string","const":"financial-event"},"recordId":{"type":"string"},"eventType":{"type":"string"},"balanceSheetRole":{"type":"string"},"measures":{"type":"array","items":{"type":"object"}},"effectiveAt":{"type":["string","null"]},"version":{"$ref":"#/components/schemas/Version"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"DatasetMeta":{"type":"object","additionalProperties":false,"required":["apiVersion","knowledgeAsOf","effectiveAsOf","payloadSha256","coverage"],"properties":{"apiVersion":{"type":"string","const":"wealth-api-v1"},"knowledgeAsOf":{"type":"string"},"effectiveAsOf":{"type":["string","null"]},"payloadSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"coverage":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["domain","status"],"properties":{"domain":{"type":"string","enum":["bb","cp","siw"]},"status":{"type":"string","enum":["admitted","runtime-not-loaded"]}}}}}},"PeopleSearchResponse":{"type":"object","additionalProperties":false,"required":["data","search","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["people"],"properties":{"people":{"type":"array","items":{"$ref":"#/components/schemas/Person"}}}},"search":{"type":"object","additionalProperties":false,"required":["query","limit","total","hasMore"],"properties":{"query":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":25},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}}},"meta":{"$ref":"#/components/schemas/DatasetMeta"}}},"PersonResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["person","current"],"properties":{"person":{"$ref":"#/components/schemas/Person"},"current":{"type":"object","additionalProperties":false,"required":["estimates","ownership","components","valuations"],"properties":{"estimates":{"type":"array","items":{"$ref":"#/components/schemas/WealthEstimate"}},"ownership":{"type":"array","items":{"$ref":"#/components/schemas/Ownership"}},"components":{"type":"array","items":{"$ref":"#/components/schemas/WealthComponent"}},"valuations":{"type":"array","items":{"$ref":"#/components/schemas/Valuation"}}}}}},"meta":{"$ref":"#/components/schemas/DatasetMeta"}}},"OwnershipResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["person","ownership"],"properties":{"person":{"$ref":"#/components/schemas/Person"},"ownership":{"type":"array","items":{"$ref":"#/components/schemas/Ownership"}}}},"meta":{"$ref":"#/components/schemas/DatasetMeta"}}},"HistoryRecord":{"oneOf":[{"$ref":"#/components/schemas/Ownership"},{"$ref":"#/components/schemas/WealthEstimate"},{"$ref":"#/components/schemas/WealthComponent"},{"$ref":"#/components/schemas/Valuation"},{"$ref":"#/components/schemas/FinancialEvent"}]},"HistoryResponse":{"type":"object","additionalProperties":false,"required":["data","pagination","meta"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["person","records"],"properties":{"person":{"$ref":"#/components/schemas/Person"},"records":{"type":"array","items":{"$ref":"#/components/schemas/HistoryRecord"}}}},"pagination":{"type":"object","additionalProperties":false,"required":["limit","offset","total","hasMore"],"properties":{"limit":{"type":"integer","minimum":1,"maximum":500},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}}},"meta":{"$ref":"#/components/schemas/DatasetMeta"}}}}}}