{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://github.com/william-wei-zhu/pbcindex/schema/company.schema.json","title":"pbcindex company entry","description":"A US company with mission-locking governance: a legal Public Benefit Corporation, a certified B Corp, or another structure that protects mission from short-term shareholder pressure.","type":"object","additionalProperties":false,"required":["slug","name","governance_types","status","sources","verification_status","date_added","last_updated"],"properties":{"slug":{"type":"string","description":"URL-safe unique identifier. Lowercase, hyphenated.","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","description":"Common / brand name.","minLength":1},"legal_name":{"type":"string","description":"Registered legal entity name, if known."},"website":{"type":"string","description":"Primary website URL.","format":"uri"},"logo_url":{"type":"string","description":"URL of the company logo or favicon, for a visual directory.","format":"uri"},"governance_types":{"type":"array","description":"All mission-locking structures this company holds. A company can hold several (e.g. a legal PBC that is also a certified B Corp).","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["pbc","certified_b_corp","steward_owned","perpetual_purpose_trust","golden_share","other"]}},"statutory_form":{"type":"string","description":"The statutory benefit-corporation form behind a \"pbc\" entry. public_benefit_corp = a Public Benefit Corporation (Delaware DGCL Subchapter XV and other states); benefit_corp = a model Benefit Corporation; social_purpose_corp = a Washington/California Social Purpose Corporation; other = any further statutory benefit form. Present when governance_types includes \"pbc\".","enum":["public_benefit_corp","benefit_corp","social_purpose_corp","other"]},"statutory_jurisdiction":{"type":"string","description":"US state of incorporation for the statutory form (e.g. \"Delaware\", \"Washington\"). Pairs with statutory_form."},"b_corp":{"type":"object","description":"B Lab certification details. Present when governance_types includes \"certified_b_corp\".","additionalProperties":false,"properties":{"certified":{"type":"boolean"},"certification_date":{"type":"string","description":"ISO 8601 date or year."},"score":{"type":"number"}},"required":["certified"]},"status":{"type":"string","description":"Public (traded) or private company.","enum":["public","private"]},"ticker":{"type":"string","description":"Stock ticker symbol. Present when status is \"public\"."},"founded_year":{"type":"integer","minimum":1600,"maximum":2100},"headquarters":{"type":"object","additionalProperties":false,"properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"}}},"categories":{"type":"array","description":"Broad industry/sector tags for filtering (e.g. \"Food\", \"Fintech\", \"Healthcare\").","uniqueItems":true,"items":{"type":"string","minLength":1}},"public_benefit_purpose":{"type":"string","description":"The specific public benefit named in the charter, or the company's stated mission."},"sources":{"type":"array","description":"Provenance. At least one credible source is mandatory for every entry.","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["url","retrieved_date"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"type":{"type":"string","description":"Kind of source.","enum":["sec_filing","company_website","press_release","news_article","b_lab_directory","legal_filing","other"]},"retrieved_date":{"type":"string","description":"ISO 8601 date the source was retrieved.","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}}},"verification_status":{"type":"string","description":"verified: governance confirmed by a credible source. needs_review: candidate, source weak or unconfirmed. unverified: no confirmation yet.","enum":["verified","needs_review","unverified"]},"date_added":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"last_updated":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"notes":{"type":"string"}},"allOf":[{"if":{"properties":{"status":{"const":"public"}}},"then":{"required":["ticker"]}}]}