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 |
| The name of the person. |
titles |
| An array of objects, each representing a position within the business which the person holds. |
submitted |
| Indicates whether this person was submitted at the time you created the business ( |
titles[].title |
| The title of the position the person holds. |
sources |
| A nested object containing the source details for each source where the person was identified. |
sources[].type |
| The source type for the person. Possible values are:
|
sources[].metadata |
| A nested object containing the specific details for each person source. |
sources[].metadata.file_number |
| The unique identifier of the Secretary of State record where that person was found. |
sources[].metadata.state |
| The specific state where the person was found |
sources[].metadata.status |
| The current filing status of the business within the given state according to the source record. Possible values are:
|
kyc_result |
| 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 |
| 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 |
| The final decision on this person from KYC's Socure request. The result can be See Socure's docs for more details |