Person

A business can have many people.

When a KYC order is requested, the person will include a kyc_result with the status of the Socure KYC request.

{
  "object": "person",
  "name": "John Doe",
  "submitted": false,
  "titles": [
    {
      "object": "person_title",
      "title": "president"
    },
    {
      "object": "person_title",
      "title": "registered agent"
    }
  ],
  "sources": [
    {
      "id": "5d1308ad-0d33-472d-8e61-ed223649d074",
      "type": "registration",
      "metadata": {
        "state": "CA",
        "status": "active",
        "file_number": "C4221590"
      }
    }
  ],
  "kyc_result": {
    "id": "5d1308ad-0d33-472d-8e61-ed223649d074",
    "object": "kyc_result",
    "reference_id": "2cf895d3-83a0-4b2c-a5f2-aa49dd0fc591",  
    "decision": "accept"
  }
}

Attribute	Type	Description
name	`string`	The name of the person.
titles	`object []`	An array of objects, each representing a position within the business which the person holds.
submitted	`boolean`	Indicates whether this person was submitted at the time you created the business (`true`), or was found over the course of searching Secretary of State records (`false`).
titles[].title	`string`	The title of the position the person holds.
sources	`object []`	A nested object containing the source details for each source where the person was identified.
sources[].type	`string`	The source type for the person. Possible values are: `registration` - The person was found based on government registration records
sources[].metadata	`object []`	A nested object containing the specific details for each person source.
sources[].metadata.file_number	`string`	The unique identifier of the Secretary of State record where that person was found.
sources[].metadata.state	`string`	The specific state where the person was found
sources[].metadata.status	`string`	The current filing status of the business within the given state according to the source record. Possible values are: `active` - The business license is active in that state `inactive` - The business license is inactive in that state `unknown` - The state does not provide business license status
kyc_result	`object []`	An object containing the person's KYC results Note: KYC is a premium feature. Talk to sales to have it enabled
kyc_result.reference_id	`string`	An external id unique to the person's Socure request. This id can be used on Socure's website to see more in depth details about the person's KYC order
*kyc_result.decision	`string`	The final decision on this person from KYC's Socure request. The result can be `reject`, `refer`, `resubmit`, `review`, or `accept` See Socure's docs for more details