Person object | Middesk

This page describes the results Middesk returns after running orders related to owners and officers.

Order type	Person object field
KYC	`kyc` object
Bankruptcy	`people_bankruptcies` array
Tax liens	`liens` array
Litigations	`litigations` array
Criminal history	`criminal_records` array

Example JSON response

1 {
2   "object": "person",
3   "name": "John Doe",
4   "submitted": false,
5   "titles": [
6     {
7       "object": "person_title",
8       "title": "president"
9     },
10     {
11       "object": "person_title",
12       "title": "registered agent"
13     }
14   ],
15   "sources": [
16     {
17       "id": "5d1308ad-0d33-472d-8e61-ed223649d074",
18       "type": "registration",
19       "metadata": {
20         "state": "CA",
21         "status": "active",
22         "file_number": "C4221590"
23       }
24     }
25   ],
26   "kyc": {
27     "object": "kyc_result",
28     "provider_external_id": "2cf895d3-83a0-4b2c-a5f2-aa49dd0fc591",
29     "provider": "socure",
30     "decision": "accept",
31     "result": {}
32   },
33   "people_bankruptcies": [
34     {
35       "object": "people_bankruptcy",
36       "id": "bde7539e-0eef-4c64-bdd9-b9210aa5d40f",
37       "case_number": "2:2014bk27412",
38       "case_updates": [],
39       "chapter": 13,
40       "court": "Utah Bankruptcy Court",
41       "case_link": "https://ecf.utb.uscourts.gov/cgi-bin/iqquerymenu.pl?1234321",
42       "filing_date": "2014-07-17T00:00:00.000Z",
43       "debtors": [
44         {
45           "name": "John Doe"
46         }
47       ],
48       "person_id": "0190c159-e9fe-4233-9b49-9e03e1f02873"
49     }
50   ]
51 }

Person attributes

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. KYC is a premium feature. Talk to Middesk Sales to enable it.
`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 has an outdated decision. In that case, 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. These fields change 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 is only 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 (example: `2:2017bk27401`).
`people_bankruptcies[].chapter`	string	The bankruptcy chapter (example: `13`).
`people_bankruptcies[].case_updates`	object []	An optional array containing any relevant case updates.
`people_bankruptcies[].court`	string	The bankruptcy court (example: `Utah Bankruptcy Court`).
`people_bankruptcies[].filing_date`	string	The date/time when the bankruptcy case was filed (example: `2014-07-17T00:00:00.000Z`).
`people_bankruptcies[].debtors`	object []	An array of objects representing the debtors on the case (example: `[{"name": "John Doe"}]`).
`people_bankruptcies[].case_link`	string	The link to the PACER case (example: `https://ecf.utb.uscourts.gov/cgibin/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 also shows 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 (example: `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 (example: `Plaintiff`, `Defendant`).
`criminal_records[].id`	string	The criminal record ID, assigned by Middesk.
`criminal_records[].category`	string	The category of the criminal record (example: `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.
`criminal_records[].cases[].charges[].charge_type`	string	The type of the charge (Example: `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.

Get a demo

Contact your account manager or contact sales to inquire about access.