Create a business

POST

https://api.middesk.com/v1/businesses

POST

/v1/businesses

$ curl -X POST https://api.middesk.com/v1/businesses \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Agent",
>   "addresses": [
>     {
>       "full_address": "369 Willow St, Phoenix, AZ 85001"
>     }
>   ],
>   "tin": {
>     "tin": "123456789"
>   },
>   "orders": [
>     {
>       "product": "identity"
>     }
>   ]
> }'

1 {
2   "object": "business",
3   "id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
4   "name": "Agent",
5   "status": "open",
6   "created_at": "2025-11-05T01:57:42Z",
7   "updated_at": "2025-11-05T01:57:42Z",
8   "tags": [
9     "tags"
10   ],
11   "requester": {
12     "id": "d903a801-88e0-441f-bc5f-49593163e755",
13     "type": "account",
14     "name": "Example Account",
15     "requested_at": "2025-11-05T01:57:42Z"
16   },
17   "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c",
18   "supported_document_types": [
19     "Articles of Incorporation"
20   ],
21   "tin": {
22     "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
23     "tin": "12-3456789",
24     "mismatch": false,
25     "unknown": false,
26     "updated_at": "2025-11-05T01:57:42Z"
27   },
28   "risk": {
29     "object": "risk",
30     "status": "completed",
31     "level": "low",
32     "score": 1,
33     "latest_assessment_id": "latest_assessment_id",
34     "reason": "reason"
35   },
36   "bankruptcies": [
37     {
38       "object": "bankruptcy",
39       "id": "id",
40       "business_id": "business_id",
41       "case_number": "case_number",
42       "case_updates": [
43         {}
44       ],
45       "chapter": 1.1,
46       "court": "court",
47       "filing_date": "2023-01-15",
48       "debtors": [
49         {}
50       ]
51     }
52   ],
53   "certifications": [
54     {
55       "object": "certification",
56       "name": "name",
57       "key": "key",
58       "certification_type": "federal",
59       "external_sources": [
60         {}
61       ],
62       "id": "id",
63       "business_id": "business_id",
64       "created_at": "2024-01-15T09:30:00Z",
65       "updated_at": "2024-01-15T09:30:00Z",
66       "entrance_date": "2024-01-15T09:30:00Z",
67       "exit_date": "2024-01-15T09:30:00Z",
68       "certification_id": "certification_id"
69     }
70   ],
71   "documents": [
72     {
73       "object": "document",
74       "id": "id",
75       "document_type": "document_type",
76       "filename": "filename",
77       "content_type": "application/pdf",
78       "size": 1,
79       "download_url": "download_url",
80       "created_at": "2024-01-15T09:30:00Z",
81       "filing_date": "2024-01-15T09:30:00Z",
82       "metadata": {
83         "key": "value"
84       }
85     }
86   ],
87   "liens": [
88     {
89       "object": "lien",
90       "type": "ucc",
91       "id": "id",
92       "business_id": "business_id",
93       "debtors": [
94         {}
95       ],
96       "secured_parties": [
97         {}
98       ],
99       "file_number": "file_number",
100       "state": "AL",
101       "status": "created",
102       "filing_date": "2023-01-15",
103       "status_category": "active",
104       "owner_id": "owner_id",
105       "owner_type": "owner_type",
106       "documents": [
107         {
108           "object": "document",
109           "id": "id",
110           "document_type": "document_type",
111           "filename": "filename",
112           "content_type": "application/pdf",
113           "size": 1,
114           "download_url": "download_url",
115           "created_at": "2024-01-15T09:30:00Z"
116         }
117       ],
118       "updated_date": "2023-01-15",
119       "lapse_date": "2023-01-15",
120       "collateral": "collateral",
121       "collateral_type": "Blanket",
122       "negative_pledge": true,
123       "confirmation_number": "confirmation_number",
124       "loan_principal_amount_cents": 1,
125       "source": "source",
126       "packet_number": "packet_number",
127       "lien_termination": {
128         "key": "value"
129       },
130       "liability_cents": 1,
131       "alternative_designation": "buyer_seller",
132       "filed_by_account": true
133     }
134   ],
135   "names": [
136     {
137       "object": "name",
138       "id": "764682dd-bf80-4426-910c-9850531fc86c",
139       "name": "Agent",
140       "submitted": true,
141       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
142       "sources": [
143         {
144           "id": "id",
145           "type": "type",
146           "metadata": {
147             "key": "value"
148           }
149         }
150       ],
151       "type": "legal"
152     }
153   ],
154   "addresses": [
155     {
156       "object": "address",
157       "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
158       "full_address": "369 Willow St, Phoenix, AZ 85001",
159       "submitted": true,
160       "created_at": "2025-11-05T01:57:42Z",
161       "updated_at": "2025-11-05T01:57:42Z",
162       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
163       "sources": [
164         {
165           "id": "id",
166           "type": "type",
167           "metadata": {
168             "key": "value"
169           }
170         }
171       ],
172       "rating": {
173         "risk_rating": "not_available"
174       },
175       "deliverable": false,
176       "labels": [
177         "labels"
178       ],
179       "references": [
180         "references"
181       ],
182       "cmra": false
183     }
184   ],
185   "people": [
186     {
187       "object": "person",
188       "id": "id",
189       "name": "name",
190       "submitted": true,
191       "business_id": "business_id",
192       "titles": [
193         {}
194       ],
195       "people_bankruptcies": [
196         {
197           "key": "value"
198         }
199       ],
200       "litigations": [
201         {
202           "object": "litigation",
203           "id": "id",
204           "case_name": "case_name",
205           "case_number": "case_number",
206           "case_status": "OPEN",
207           "case_type": "case_type",
208           "filing_date": "2025-06-18",
209           "party_type": "party_type"
210         }
211       ],
212       "liens": [
213         {
214           "object": "lien",
215           "type": "ucc",
216           "id": "id",
217           "business_id": "business_id",
218           "debtors": [
219             {}
220           ],
221           "secured_parties": [
222             {}
223           ],
224           "file_number": null,
225           "state": "AL",
226           "status": "created",
227           "filing_date": null,
228           "status_category": "active",
229           "owner_id": "owner_id",
230           "owner_type": "owner_type",
231           "documents": [
232             {
233               "object": "document",
234               "id": "id",
235               "document_type": "document_type",
236               "filename": "filename",
237               "content_type": "application/pdf",
238               "size": 1,
239               "download_url": "download_url",
240               "created_at": "2024-01-15T09:30:00Z"
241             }
242           ]
243         }
244       ],
245       "criminal_records": [
246         {
247           "object": "criminal_history/record",
248           "id": "id",
249           "category": "category",
250           "cases": [
251             {
252               "object": "criminal_history/case",
253               "charges": [
254                 {
255                   "object": "criminal_history/charge"
256                 }
257               ]
258             }
259           ]
260         }
261       ],
262       "sources": [
263         {
264           "id": "id",
265           "type": "type",
266           "metadata": {
267             "key": "value"
268           }
269         }
270       ]
271     }
272   ],
273   "phone_numbers": [
274     {
275       "object": "phone_number",
276       "id": "id",
277       "number": "number",
278       "contact_type": "contact_type",
279       "recommended": true
280     }
281   ],
282   "email_addresses": [
283     {
284       "object": "email_address",
285       "id": "id",
286       "email": "email",
287       "submitted": true,
288       "sources": [
289         {
290           "id": "id",
291           "type": "type",
292           "metadata": {
293             "key": "value"
294           }
295         }
296       ],
297       "domain": "domain",
298       "valid": true,
299       "deliverability": "deliverability",
300       "disposable": true,
301       "address_type": "disposable",
302       "business_id": "business_id",
303       "domain_age": "2024-01-15T09:30:00Z",
304       "first_seen": "2024-01-15T09:30:00Z",
305       "rating": {
306         "risk_rating": "low"
307       }
308     }
309   ],
310   "profiles": [
311     {
312       "object": "profile",
313       "id": "id",
314       "type": "facebook",
315       "url": "url",
316       "external_id": "external_id",
317       "rating": 1.1,
318       "rating_count": 1
319     }
320   ],
321   "registrations": [
322     {
323       "object": "registration",
324       "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12",
325       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
326       "name": "Agent",
327       "status": "active",
328       "jurisdiction": "HOME",
329       "entity_type": "CORPORATION",
330       "file_number": "123456789",
331       "state": null,
332       "sub_status": "GOOD_STANDING",
333       "jurisdiction_details": {
334         "name": "Alberta",
335         "abbr": "AB",
336         "authority": "Corporate Registry System (CORES)"
337       },
338       "country_code": "CA",
339       "addresses": [
340         "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA"
341       ],
342       "officers": [
343         {
344           "key": "value"
345         }
346       ],
347       "registration_date": "2019-04-12",
348       "submitted": true
349     }
350   ],
351   "orders": [
352     {
353       "object": "order",
354       "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7",
355       "status": "created",
356       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
357       "product": "business_verification_verify",
358       "created_at": "2025-11-05T01:57:42Z",
359       "updated_at": "2025-11-05T01:57:42Z",
360       "subproducts": [
361         "Articles of Incorporation"
362       ],
363       "monitoring": false,
364       "requester": {
365         "name": "Example Account",
366         "type": "account"
367       }
368     },
369     {
370       "object": "order",
371       "id": "6e71a276-ebf4-4396-b091-3e13251a25c6",
372       "status": "created",
373       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
374       "product": "litigations",
375       "created_at": "2025-11-05T01:57:42Z",
376       "updated_at": "2025-11-05T01:57:42Z",
377       "subproducts": [
378         "Articles of Incorporation"
379       ],
380       "monitoring": false,
381       "requester": {
382         "name": "Example Account",
383         "type": "account"
384       }
385     },
386     {
387       "object": "order",
388       "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140",
389       "status": "created",
390       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
391       "product": "bankruptcies",
392       "created_at": "2025-11-05T01:57:42Z",
393       "updated_at": "2025-11-05T01:57:42Z",
394       "subproducts": [
395         "Articles of Incorporation"
396       ],
397       "monitoring": false,
398       "requester": {
399         "name": "Example Account",
400         "type": "account"
401       }
402     },
403     {
404       "object": "order",
405       "id": "1276547b-1cca-416f-b451-22e4a24c25fb",
406       "status": "created",
407       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
408       "product": "ucc_liens",
409       "created_at": "2025-11-05T01:57:42Z",
410       "updated_at": "2025-11-05T01:57:42Z",
411       "subproducts": [
412         "Articles of Incorporation"
413       ],
414       "monitoring": false,
415       "requester": {
416         "name": "Example Account",
417         "type": "account"
418       }
419     },
420     {
421       "object": "order",
422       "id": "bca42881-ed2a-4de9-84c3-25795e280bf3",
423       "status": "created",
424       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
425       "product": "tax_liens",
426       "created_at": "2025-11-05T01:57:42Z",
427       "updated_at": "2025-11-05T01:57:42Z",
428       "subproducts": [
429         "Articles of Incorporation"
430       ],
431       "monitoring": false,
432       "requester": {
433         "name": "Example Account",
434         "type": "account"
435       }
436     }
437   ],
438   "fmcsa_registrations": [
439     {
440       "object": "fmcsa_registration",
441       "id": "id",
442       "dot_number": "dot_number",
443       "legal_name": "legal_name",
444       "source": "source",
445       "addresses": [
446         "addresses"
447       ],
448       "dba_name": "dba_name"
449     }
450   ],
451   "loans": [
452     {
453       "object": "loan",
454       "id": "id",
455       "issued_date": "2023-01-15",
456       "amount": 1.1,
457       "lender": "lender"
458     }
459   ],
460   "litigations": [
461     {
462       "object": "litigation",
463       "id": "id",
464       "case_name": "case_name",
465       "case_number": "case_number",
466       "case_status": "OPEN",
467       "case_type": "case_type",
468       "filing_date": "2025-06-18",
469       "party_type": "party_type",
470       "judgments": [
471         {
472           "id": "id",
473           "litigation_id": "litigation_id",
474           "docket_entry_date": "2023-01-15",
475           "text": "text",
476           "created_at": "2024-01-15T09:30:00Z",
477           "updated_at": "2024-01-15T09:30:00Z"
478         }
479       ],
480       "jurisdiction": "jurisdiction",
481       "jurisdiction_state": "jurisdiction_state",
482       "parties": [
483         {
484           "id": "id",
485           "name": "name",
486           "role": "Plaintiff",
487           "litigation_id": "litigation_id"
488         }
489       ]
490     }
491   ],
492   "policy_results": [
493     {
494       "object": "policy_result",
495       "id": "id",
496       "result": "result",
497       "created_at": "created_at",
498       "matched": "matched",
499       "executed": true,
500       "name": "name",
501       "details": {
502         "key": "value"
503       },
504       "owner_id": "owner_id",
505       "owner_type": "owner_type",
506       "business_id": "business_id",
507       "type_of": "type_of",
508       "policy_action_results": [
509         {
510           "object": "policy_action_result"
511         }
512       ]
513     }
514   ],
515   "submitted": {
516     "object": "submitted_attributes",
517     "name": "Agent",
518     "name_derived": true,
519     "addresses": [
520       {
521         "full_address": "369 Willow St, Phoenix, AZ 85001"
522       }
523     ],
524     "orders": [
525       {}
526     ],
527     "people": [
528       {
529         "key": "value"
530       }
531     ],
532     "phone_numbers": [
533       {
534         "key": "value"
535       }
536     ],
537     "email_addresses": [
538       {
539         "key": "value"
540       }
541     ],
542     "tin": {
543       "tin": "123456789"
544     },
545     "website": {
546       "key": "value"
547     },
548     "profiles": [
549       {
550         "key": "value"
551       }
552     ]
553   },
554   "subscription_availability": {
555     "bankruptcy": "subscribable",
556     "certification": "subscribable",
557     "registration": "subscribable",
558     "tin": "subscribable",
559     "watchlist_result": "subscribable",
560     "lien": "subscribable"
561   }
562 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

addresseslist of objectsRequired

tinobjectOptional

websiteobjectOptional

Website information for the business. Required when name and addresses are not provided when ordering the web_analysis and/or industry_classification subproducts.

phone_numberslist of objectsOptional

Phone numbers for the business.

peoplelist of objectsOptional

external_idstringOptional

unique_external_idstringOptional

tagslist of stringsOptional

connection_idstringOptional

The ID of a connection to use as the source for this business. Pre-fills the business name and address from the connection.

orderslist of objectsOptional

Orders to place against the business at creation time. Each order specifies a product (and optional subproducts/options) to run.

registrationslist of objectsOptional

Known international registrations to look up for the business. Requires the International Business Verification package to be enabled for your account. If omitted, Middesk searches for international registrations based on the submitted addresses.

Response

business created

objectstring

idstringformat: "uuid"

namestring

statusenum

Current status of the business verification

created_atdatetime

updated_atdatetime

external_idstring or nullOptional

unique_external_idstring or nullOptional

tagslist of stringsOptional

requesterobject or nullOptional

assignee_idstring or nullOptionalformat: "uuid"

supported_document_typeslist of enumsOptional

reviewobject or nullOptional

tinobject or nullOptional

business_batch_idstring or nullOptionalformat: "uuid"

formationobject or nullOptional

websiteobject or nullOptional

watchlistobject or nullOptional

riskobject or nullOptional

Top-level risk outcome for the business. Populated once a Risk order reaches a terminal state (completed with a verdict, or unavailable). null while a Risk order is still in flight. This is the business-level risk outcome; granular per-resource assessments live on the Risk Assessment resource, not here.

bankruptcieslist of objectsOptional

certificationslist of objectsOptional

documentslist of objectsOptional

lienslist of objectsOptional

nameslist of objectsOptional

addresseslist of objectsOptional

peoplelist of objectsOptional

phone_numberslist of objectsOptional

email_addresseslist of objectsOptional

profileslist of objectsOptional

registrationslist of objectsOptional

orderslist of objectsOptional

industry_classificationobject or nullOptional

monitorobject or nullOptional

tax_exempt_organizationobject or nullOptional

fmcsa_registrationslist of objectsOptional

loanslist of objects or nullOptional

litigationslist of objectsOptional

policy_resultslist of objectsOptional

politically_exposed_person_screeningobject or nullOptional

adverse_media_screeningobject or nullOptional

signalobject or nullOptional

submittedobjectOptional

subscriptionobject or nullOptional

subscription_availabilityobject or nullOptional

Errors

422

Create Business Request Unprocessable Entity Error

429

Create Business Request Too Many Requests Error

503

Create Business Request Service Unavailable Error