Person

A business can have many people.

When a KYC order is requested, the person will include a kyc object. See KYC for more details.

When a People Bankruptcy order is requested, the person will include a people_bankruptcies array. See Orders for more details.

when a People Tax Liens order is requested, the person will include a liens array.

When a People Litigations order is requested, the person will include a litigations array.

When a People Criminal History order is requested, the person will include a criminal_records array.

{
  "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": {
    "object": "kyc_result",
    "provider_external_id": "2cf895d3-83a0-4b2c-a5f2-aa49dd0fc591",
    "provider": "socure",
    "decision": "accept",
    "result": {}
   },
  "people_bankruptcies": [
    {
      "object": "people_bankruptcy",
      "id": "bde7539e-0eef-4c64-bdd9-b9210aa5d40f",
      "case_number": "2:2014bk27412",
      "case_updates": [],
      "chapter": 13,
      "court": "Utah Bankruptcy Court",
      "case_link": "https://ecf.utb.uscourts.gov/cgi-bin/iqquerymenu.pl?1234321",
      "filing_date": "2014-07-17T00:00:00.000Z",
      "debtors": [
        {
          "name": "John Doe"
        }
      ],
      "person_id": "0190c159-e9fe-4233-9b49-9e03e1f02873"
    }
  ]
}

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	`object []`	An object containing the person's KYC results Note: KYC is a premium feature. Talk to sales to have it enabled.
kyc.provider_external_id	`string`	An external id unique to the person's Socure request. This id can be used on Socure's dashboard to see more in depth details about the person's KYC order.
kyc.decision	`string`	The decision on this person from Socure if the `decision` module was enabled. The result can be `null` if the `decision` module wasn't requested or`reject`, `refer`, `resubmit`, `review`, or `accept`. Note that if Socure's Document Verification is used as a step-up method, this field will have an outdated decision. In that case, you should refer to `kyc_step_up.document_verification.decision` for the latest details. See Socure's decision module guide for more details (Socure login required).
kyc.result	`object []`	An object containing all of the raw information returned from Socure about this person. Note that these fields will changed based on what Socure modules you have enabled on your account. See Socure's docs for more details of the available fields (Socure login required)
kyc_step_up	`object []`	An object containing the person's KYC Document Verification step-up results. This field will only be present if Document Verification is used as a step-up method, not if it is included in the original KYC request.
kyc_step_up.provider_external_id	`string`	An external id unique to the person's Document Verification Socure request. This id can be used on Socure's dashboard to see more in depth details about the person's order.
kyc_step_up.decision	string	The new decision on this person from Socure, after using Document Verification as a step-up method. The result can be`reject`, `refer`, `resubmit`, `review`, or `accept`.
kyc_step_up.document_verification	`object`	An object containing details on the Document Verification used as a step-up method. This includes the document data.
people_bankruptcies	`object []`	An object containing the bankruptcies associated with the person.
people_bankruptcies[].case_number	`string`	The bankruptcy case number (ex. `2:2017bk27401`).
people_bankruptcies[].chapter	`string`	The bankruptcy chapter (ex. `13`).
people_bankruptcies[].case_updates	`object []`	An optional array containing any relevant case updates.
people_bankruptcies[].court	`string`	The bankruptcy court (ex. `Utah Bankruptcy Court`).
people_bankruptcies[].filing_date	`string`	The date/time when the bankruptcy case was filed (ex. `2014-07-17T00:00:00.000Z`).
people_bankruptcies[].debtors	`object []`	An array of objects representing the debtors on the case (ex. `[{"name": "John Doe"}]`).
people_bankruptcies[].case_link	`string`	The link to the PACER case (ex. `https://ecf.utb.uscourts.gov/cgi-bin/iqquerymenu.pl?1234321`)
liens[].type	`string`	The type of lien ("ucc", "state", or "federal").
liens[].state	`string`	The state in which the lien was filed.
liens[].status	`string`	The status of the lien. One of `open`, `closed`, or `unknown`.
liens[].debtors[].addresses	`Address[]`	Addresses associated with the debtor
liens[].debtors[].name	`string`	The name of the debtor
liens[].secured_parties[].addresses	`Address[]`	Addresses associated with the secured party
liens[].secured_parties[].name	`string`	The name of the secured party
liens[].filing_date	`string`	The date on which the lien was filed.
liens[].lapse_date	`string`	The date on which the lien is set to expire.
liens[].updated_date	`string`	The date on which the filing was updated, if applicable.
liens[].negative_pledge	`boolean`	Whether or not the debtor(s) are able to extend a pledge of its assets to a lender besides the secured party.
liens[].source	`string`	Link to primary lien data.
liens[].liability_cents	`integer`	The total liability in cents (available for federal tax liens).
liens[].documents	`Document[]`	The UCC documents associated with this lien. The document_type for a UCC1 is "Initial Filing". For more details, see the Document API reference. If the Search to Reflect feature is enabled, the UCC-1 document will also show up in this object.
liens[].collateral	`string`	A description of the lien collateral
liens[].collateral_type	"Blanket", "Collateral", or "Unknown"	"Blanket" if the collateral represents all assets, "Collateral" if it covers specific collateral, or "Unknown" if we are unable to determine the type.
litigations[].id	`string`	The litigation id, assigned by Middesk.
litigations[].case_name	`string`	The name of the court case.
litigations[].case_number	`string`	The case number.
litigations[].case_status	`string`	The status of the case (`Open`, `Closed`, or `Unknown`).
litigations[].case_type	`string`	The type of case (i.e. `Debt Collection` or `Unknown`)
litigations[].filing_date	`string`	The date when the case was filed.
litigations[].judgments	`array`	Array of court docket information that may include judgments. Each object can have a `docket_entry_date` and `text`.
litigations[].jurisdiction	`string`	The jurisdiction where the case was filed.
litigations[].party_type	`string`	The party type of the business (ex. `Plaintiff`, `Defendant`).
criminal_records[].id	`string`	The criminal record id, assigned by Middesk
criminal_records[].category	`string`	The category of the criminal record (ex: `Criminal/traffic`)
criminal_records[].person.dob	`date`	The DOB on the criminal record
criminal_records[].cases[].arrest_date	`date`	Arrest date
criminal_records[].cases[].arresting_agency	`string`	Arresting agency
criminal_records[].cases[].case_number	`string`	The case number for the criminal record
criminal_records[].cases[].case_type	`string`	The case type
criminal_records[].cases[].court_county	`string`	The court county of the case
criminal_records[].cases[].court_name	`string`	The court name
criminal_records[].cases[].file_date	`string`	The date when the case was filed.
criminal_records[].cases[].status	`string`	Case status
criminal_records[].cases[].charges[].category	`string`	The category of the charge (Ex.:
criminal_records[].cases[].charges[].charge_type	`string`	The type of the charge (Ex: `misdemeanor`)
criminal_records[].cases[].charges[].city	`string`	The city where the charge occurred.
criminal_records[].cases[].charges[].county	`string`	The county where the charge occurred
criminal_records[].cases[].charges[].description	`string`	Description of the charge
criminal_records[].cases[].charges[].dispositions	`array`	Dispositions associated with the charge
criminal_records[].cases[].charges[].legal_code	`string`	Legal code of the charge
criminal_records[].cases[].charges[].offense_date	`string`	The date of the offense
criminal_records[].cases[].charges[].sentences	`array`	Sentences associated with the charge
criminal_records[].cases[].charges[].state	`string`	The state that the charge was issued in.
criminal_records[].cases[].charges[].subcategory	`string`	Subcategory of the charge
criminal_records[].cases[].charges[].subsubcategory	`string`	Subsubcategory of the charge