Create a business

POST

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

POST

/v1/businesses

1 curl -X POST https://api.middesk.com/v1/businesses \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "name": "Agent",
6   "addresses": [
7     {
8       "full_address": "369 Willow St, Phoenix, AZ 85001"
9     }
10   ],
11   "tin": {
12     "tin": "123456789"
13   }
14 }'

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

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.

peoplelist of objectsOptional

external_idstringOptional

unique_external_idstringOptional

tagslist of stringsOptional

Response

business created

objectstring

idstringformat: "uuid"

namestring

statusenum

Current status of the business verification

created_atdatetime

updated_atdatetime

external_idstring or null

unique_external_idstring or null

tagslist of strings

requesterobject or null

assignee_idstring or nullformat: "uuid"

supported_document_typeslist of enums

Allowed values:

reviewobject or null

tinobject or null

business_batch_idstring or nullformat: "uuid"

formationobject or null

websiteobject or null

watchlistobject or null

bankruptcieslist of objects

certificationslist of objects

documentslist of objects

lienslist of objects

nameslist of objects

addresseslist of objects

peoplelist of objects

phone_numberslist of objects

profileslist of objects

registrationslist of objects

orderslist of objects

industry_classificationobject or null

monitorobject or null

tax_exempt_organizationobject or null

fmcsa_registrationslist of objects

loanslist of objects or null

litigationslist of objects

policy_resultslist of objects

politically_exposed_person_screeningobject or null

adverse_media_screeningobject or null

signalobject or null

submittedobject

subscriptionobject or null

subscription_availabilityobject or null

Errors

422

Create Business Request Unprocessable Entity Error