## Introduction This endpoint allows you to submit information for Company Officers. Prior to submitting those details you will have to upload their IDs. It is required when Company Officer owns 20 or percentage of the company. Please refer to [Upload Compnay Offcer ID](https://borderlessapi-partner.readme.io/v1.0.0/reference/post_accounts-handle-upload-documents-companyofficers) endpoint. ## Data Requirements Provide the following data when sending a POST request to the Company Officers endpoint. Additional Header parameter:

Parameter	Required?	Description	Type
Client-Id	No	Unique identifier of Child Account (required only for Partner). See Authentication Page to learn more.	String

The body of the request should contain a key of “officers” with the requested officers contained in an array. Each officer must contain the following information::

Parameter	Required?	Description	Type
name	Yes	Name of the company officer. This field includes their first name, middle name (if applicable) and last name.	String
percentOfOwnership	Yes	Positive number of the Officer's ownership of the company. Make sure that all submitted company officers sum of ownership is not more that 100%.	Number
dateOfBirth	Yes	Date of birth of Company Officer. The format of this field should be YYYY-MM-DD.	String
countryOfResidence	Yes	The two letter ISO code for the Company Officer's country of residence. You can retrieve borderless™ supported countries via Reference Section of the Payouts API.	String
zoneCode	Yes	Zone codes for Company's Officer country of residence. You can retrieve zone codes via Reference Section of the Payout API.	String
uploadedIdReference	Yes/No	The referenece of the uploaded Compnay Officer's ID. This reference number is returned in the response as documentReferenceId when successfully Uploading Company Officers ID. This field is *required* when officer owns 20 or more percent of the company.	String
jobTitle	No	A formal name for a specific position within an organization. To retrieve all possible job titles for this field please visit Reference Section.	String
residentialAddress	Yes/No	The residential address of the company officer. This is an object containing the following fields: addressLine1 (required), addressLine2 (optional), city (required), postalCode (required), and zoneCode (optional). This field is *required* when the officer owns 25% or more of the company.	Object
proofOfAddressReference	No	The reference of the uploaded proof of address document. This reference number is returned in the response as documentReferenceId when successfully uploading a proof of address document.	String

The top-level request body can also contain the following parameter:

Parameter	Required?	Description	Type
confirmOwnershipStructure	Conditional	Must be true on first submission or whenever the ownership structure has not yet been confirmed. Subsequent calls may omit it if ownership was already confirmed on a prior submission. Returns an error ("confirmOwnershipStructure is required.") if missing and ownership has not been previously confirmed.	Boolean

200Success

400Error

401Authentication Error