Business object

This page describes the business object, used to perform verification and due diligence of companies.

1{
2 "object": "business",
3 "id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
4 "name": "Middesk Inc. ",
5 "created_at": "2023-01-21T06:43:23.313Z",
6 "updated_at": "2023-01-21T06:44:07.184Z",
7 "status": "approved",
8 "addresses": [
9 {
10 "object": "address",
11 "address_line1": "2180 Bryant St Ste 210",
12 "address_line2": null,
13 "city": "San Francisco",
14 "state": "CA",
15 "postal_code": "94110-2141",
16 "full_address": "2180 Bryant St Ste 210, San Francisco, CA 94110-2141",
17 "latitude": 37.75938,
18 "longitude": -122.40994,
19 "created_at": "2019-01-30T23:49:01.100Z",
20 "updated_at": "2019-01-30T23:49:01.100Z"
21 }
22 ],
23 "orders": [
24 {
25 "object": "order",
26 "id": "12e97a44-e4ca-498f-912a-e6c72f632807",
27 "completed_at": "2023-07-18T19:47:12.392Z",
28 "created_at": "2023-07-18T19:47:09.886Z",
29 "package": "business_verification_verify",
30 "requester": {
31 "name": "Jane Doe"
32 },
33 "status": "completed",
34 "subproducts": [],
35 "updated_at": "2023-07-18T19:47:12.396Z"
36 },
37 {
38 "object": "order",
39 "id": "1db81bfc-f204-5e4d-8238-fea683bd071c",
40 "completed_at": "2023-07-18T19:47:11.765Z",
41 "created_at": "2023-07-18T19:47:09.850Z",
42 "package": "website",
43 "requester": {
44 "name": "Jane Doe"
45 },
46 "status": "completed",
47 "subproducts": [],
48 "updated_at": "2023-07-18T19:47:11.769Z"
49 }
50 ],
51 "people": [
52 {
53 "object": "person",
54 "name": "John Doe",
55 "titles": [
56 {
57 "object": "person_title",
58 "title": "president"
59 },
60 {
61 "object": "person_titles",
62 "title": "registered agent"
63 }
64 ],
65 "sources": [
66 {
67 "id": "5d1308ad-0d33-472d-8e61-ed223649d074",
68 "type": "registration",
69 "metadata": {
70 "state": "CA",
71 "status": "active",
72 "file_number": "C4221590"
73 }
74 }
75 ]
76 }
77 ],
78 "policy_results": [
79 {
80 "object": "policy_result",
81 "id": "0af5caf6-a8e4-431c-8d0a-4618ae8a2054",
82 "result": "approved",
83 "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
84 "created_at": "2023-01-21T22:23:35.432Z",
85 "matched": true,
86 "name": "Approval Policy",
87 "details": {
88 "insight_state": {
89 "name": {
90 "match": true,
91 "status": "verified"
92 },
93 "address_verification": {
94 "match": true,
95 "status": "verified"
96 }
97 },
98 "mismatched_rules": []
99 },
100 "policy_action_results": [
101 {
102 "object": "policy_action_result",
103 "id": "936d73d6-aa5c-44bc-86b9-d98b255b16fa",
104 "details": null,
105 "executed": true,
106 "policy_action": {
107 "id": "c232ad85-9a70-4292-baea-575fcb6e4a1d",
108 "action_type": "auto_decision",
109 "options": {
110 "decision": "approve"
111 },
112 "policy_version_id": "7b1e539f-b622-4615-ba1b-5fd4c1436e0c"
113 }
114 }
115 ]
116 }
117 ],
118 "tin": {
119 "object": "tin",
120 "updated_at": "2023-01-21T06:43:31.201Z",
121 "name": "Middesk Inc. ",
122 "tin": "37-1883180",
123 "mismatch": false,
124 "unknown": false,
125 "verified": true
126 },
127 "formation": {
128 "object": "formation",
129 "entity_type": "CORPORATION",
130 "formation_date": "2018-03-05",
131 "formation_state": "DE",
132 "created_at": "2023-01-30T23:49:01.164Z",
133 "updated_at": "2023-01-30T23:49:01.217Z"
134 },
135 "website": {
136 "object": "website",
137 "domain": {
138 "domain": "middesk.com",
139 "creation_date": "2018-11-20T07:02:53.000Z",
140 "expiration_date": "2019-11-20T07:02:53.000Z",
141 "registrar": {}
142 },
143 "pages": [
144 {
145 "category": "home",
146 "url": "https://www.middesk.com/"
147 }
148 ],
149 "entities": [
150 {
151 "text": "Middesk"
152 }
153 ],
154 "parked": false
155 },
156 "watchlist": {
157 "object": "watchlist",
158 "lists": [
159 {
160 "title": "Denied Persons List (DPL) - Bureau of Industry and Security",
161 "results": [],
162 "source_last_updated": "2019-01-03T18:03:07.761+00:00"
163 }
164 ]
165 },
166 "review": {
167 "object": "review",
168 "id": "0eb9094c-33fc-49eb-b5a5-18101d948857",
169 "created_at": "2020-03-06 19:20:29 UTC",
170 "updated_at": "2020-03-06 19:23:24 UTC",
171 "completed_at": "2020-03-06 19:23:24 UTC",
172 "tasks": [
173 {
174 "category": "tin",
175 "key": "tin",
176 "label": "TIN Match",
177 "message": "The IRS does not have a record for the submitted TIN and Business Name combination",
178 "status": "failure",
179 "sub_label": "Not Found"
180 },
181 {
182 "category": "name",
183 "key": "name",
184 "label": "Business Name",
185 "message": "Match identified to the submitted Business Name",
186 "status": "success",
187 "sub_label": "Verified"
188 },
189 {
190 "category": "watchlist",
191 "key": "watchlist",
192 "label": "Watchlist",
193 "message": "No Watchlist hits were identified",
194 "status": "success",
195 "sub_label": "No Hits"
196 }
197 ]
198 },
199 "registrations": [
200 {
201 "object": "registration",
202 "id": "53a101f2-d671-4c0a-89b6-6c069e5a3857",
203 "name": "MIDDESK, INC.",
204 "status": "active",
205 "status_details": null,
206 "sub_status": null,
207 "jurisdiction": "FOREIGN",
208 "entity_type": "CORPORATION",
209 "file_number": "C4221590",
210 "addresses": [
211 "2180 BRYANT ST UNIT 210 SAN FRANCISCO CA 94110"
212 ],
213 "registration_date": "2018-12-21",
214 "state": "CA",
215 "source": "https://businesssearch.sos.ca.gov/CBS"
216 },
217 {
218 "object": "registration",
219 "id": "53a101f2-d671-4c0a-89b6-6c069e5a3864",
220 "name": "MIDDESK, INC.",
221 "status": "active",
222 "status_details": null,
223 "sub_status": null,
224 "jurisdiction": "DOMESTIC",
225 "entity_type": "CORPORATION",
226 "file_number": "6782397",
227 "registration_date": "2018-03-05",
228 "state": "DE",
229 "source": "https://icis.corp.delaware.gov"
230 }
231 ],
232 "monitor": {
233 "object": "monitor",
234 "id": "2b58c9a9-8279-4e85-bcf9-60dc2a0241cb",
235 "created_at": "2023-01-21T21:05:52.100Z",
236 "event_types": [
237 {
238 "type": "bankruptcy",
239 "status": "active"
240 }
241 ]
242 }
243}

Business attributes

Middesk surfaces many pieces of information about each business.

PropertyTypeDescriptionGuaranteed
objectstringA definition of the type of object returned.yes
idstringMiddesk-generated unique identifier for the business.yes
external_idstringIdentifier from a non-Middesk system.no, populated if external_id was provided when creating the business
unique_external_idstringUnique identifier from a non-Middesk system. If a new business is created using the same unique_external_id, Middesk will not create that business. This can be used to prevent duplicate businesses.no
namestringThe given name for the company.yes
created_attimestampyes
updated_attimestampno
statusstringThe current status of the business lifecycle.yes
tinobjectInformation about the employer identification number.Guaranteed if TIN provided when creating the business. null if no TIN was provided.
formationobjectInformation about the formation of the business.nullable
registrationsobject[]List and details of all known registrations.yes, can be an empty array if no registrations found for the business.
namesobject[]Details about the business names.yes
addressesobject[]All known addresses tied to a business entity.yes
reviewobjectThe business Review.yes, empty until the business moves to in_review, approved, or rejected
ordersobject[]Determine what information is fetched on the Business. The orders field contains a business’s most recently updated orders per package. A full list of a business’s orders can be fetched using the business orders list endpoint.yes
peopleobject[]Information about people.yes, can be an empty array
policy_resultspolicy_result[]Information about policy results.yes, can be an empty array
profilesobject[]Information about profile.yes, can be an empty array
documentsobject[]Information about document.yes, can be an empty array
supported_document_typesstring[]Only present if Document Retrieval is enabled for the account. This specifies the document types available for retrieval for this particular Business. The valid values are Articles of Incorporation and Certificate of Good Standing.yes, can be an empty array
monitorobjectThe Monitor on this Business, if present.nullable
adverse_media_screeningobjectInformation about Adverse Media.nullable
bankruptciesobject[]Information about Bankruptcyyes, can be an empty array
phone_numbersobject[]Information about phone numbers.yes, can be an empty array
industry_classificationobjectInformation about industry classification.nullable
liensobject[]Information about Liensyes, can be an empty array
tagsstring[]Custom tags you can add to a Business at creation for analytics, tracking, and various other use cases.yes, can be an empty array
watchlistobjectInformation about the watchlist screeningsnull until the business moves to in_review, approved, or rejected
websiteobjectWebsite informationnullable
Get a demo
Contact your account manager or contact sales to inquire about access.