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