Hi,
I have found an issue in the API response for PSC endpoint for individual beneficial owner.
I have cross-checked information between your Web, github documentation and the responses we get from your API.
For a company I get this information on the website:
Nature of control
- Right to appoint or remove members
- Right to appoint or remove members with control over the trustees of a trust
- Right to appoint or remove members as a member of a firm
And according to your github documentation these are responses from row 147, 148, 149.
All correct so far, however, when I’m doing an API call to get this information I receive this response:
},
“natures_of_control”: [
“right-to-appoint-and-remove-members-limited-liability-partnership”,
“right-to-appoint-and-remove-members-as-trust-limited-liability-partnership”,
“right-to-appoint-and-remove-members-as-firm-limited-liability-partnership”
]
},
As you can see, the response from your API is not the same as in the website or github documentation, it seems like you have changed the “or” to “and” in the API responses. I assume the “or” is the correct term for the nature of control? Have you received this feedback before.
Thanks,
(I’m not part of Companies House). Perhaps a language quirk?
Since you refer to the rows (in the “enum constants”) I’m a bit confused what the issue is here - apart from they’ve got a slightly different formula in an identifier compared to the text it represents. I agree that the “constants” are sensible in English and so you might expect them to correspond exactly with the text they represent, but here for whatever reason it’s not the case.
So you refer to:
'right-to-appoint-and-remove-members-limited-liability-partnership' : "Right to appoint or remove members"
'right-to-appoint-and-remove-members-as-trust-limited-liability-partnership' : "Right to appoint or remove members with control over the trustees of a trust"
'right-to-appoint-and-remove-members-as-firm-limited-liability-partnership' : "Right to appoint or remove members as a member of a firm"
But … this could equally have been e.g.:
“asdfjaklsdfj3390234ks”: “Right to appoint or remove members as a member of a firm” - and then when you queried the API natures_of_control would presumably contain “asdfjaklsdfj3390234ks”
… and you’d happily look “asdfjaklsdfj3390234ks” up in the enum constants and find it “meant” (identified the text) “Right to appoint or remove members as a member of a firm”?
For what it’s worth - as commonly understood in English I would say that “right to appoint and remove (people)” would convey the same meaning as “right to appoint or remove (people)”.
(It is rather unlikely in this context that the operation of “appoint-and-remove” would exist (and not be the same as “appoint-or-remove” since if taken literally would seem a pointless exercise. Appointing someone and (immediately) removing them - the same as simply not appointing them in the first place!)
Hope this helps.