{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/companies_house/officers.json","title":"companies_house/officers data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"active_count":{"description":"Optional active count supplied by this operation. Null means unknown.","type":["number","null"]},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"address":{"description":"Optional address supplied by this operation. Null means unknown.","type":["string","null"]},"appointed_on":{"description":"Optional appointed on supplied by this operation. Null means unknown.","type":["string","null"]},"country_of_residence":{"description":"Optional country of residence supplied by this operation. Null means unknown.","type":["string","null"]},"date_of_birth":{"description":"Optional date of birth supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"month":{"description":"Optional month supplied by this operation. Null means unknown.","type":["number","null"]},"year":{"description":"Optional year supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"nationality":{"description":"Optional nationality supplied by this operation. Null means unknown.","type":["string","null"]},"role":{"description":"Optional role supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["address"],"properties":{"address":{"description":"Optional address supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["appointed_on"],"properties":{"appointed_on":{"description":"Optional appointed on supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["country_of_residence"],"properties":{"country_of_residence":{"description":"Optional country of residence supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["date_of_birth"],"properties":{"date_of_birth":{"description":"Optional date of birth supplied by this operation. Null means unknown.","type":["object"],"properties":{"month":{"description":"Optional month supplied by this operation. Null means unknown.","type":["number","null"]},"year":{"description":"Optional year supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["name"],"properties":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["nationality"],"properties":{"nationality":{"description":"Optional nationality supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["role"],"properties":{"role":{"description":"Optional role supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}}]}]}},"resigned_count":{"description":"Optional resigned count supplied by this operation. Null means unknown.","type":["number","null"]},"total_results":{"description":"Optional total results supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"active_count":0,"count":0,"items":[{"address":"example","appointed_on":"example","country_of_residence":"example","date_of_birth":{"month":0,"year":0},"name":"example","nationality":"example","role":"example"}],"resigned_count":0,"total_results":0}]}