Retrieve a business

GET

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

GET

/v1/businesses/:id

1 import requests
2 
3 url = "https://api.middesk.com/v1/businesses/id"
4 
5 headers = {"Authorization": "Bearer <token>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

1 {
2   "object": "business",
3   "id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
4   "name": "Agent",
5   "status": "in_review",
6   "created_at": "2025-11-05T01:57:42Z",
7   "updated_at": "2025-11-05T01:57:44Z",
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     "Certificate of Good Standing"
20   ],
21   "review": {
22     "object": "review",
23     "id": "17be8ac9-da36-4e10-bd99-9a4dcb520358",
24     "created_at": "2025-11-05T01:57:42Z",
25     "updated_at": "2025-11-05T01:57:42Z",
26     "tasks": [
27       {
28         "category": "tin",
29         "key": "tin",
30         "label": "TIN Match",
31         "message": "The IRS does not have a record for the submitted TIN and Business Name combination",
32         "name": "tin",
33         "status": "failure",
34         "sub_label": "Not Found",
35         "sources": [
36           {
37             "id": "id",
38             "type": "type",
39             "metadata": {
40               "key": "value"
41             }
42           }
43         ]
44       },
45       {
46         "category": "litigations",
47         "key": "litigations",
48         "label": "Litigations",
49         "message": "The business has 3 related litigations",
50         "name": "litigations",
51         "status": "failure",
52         "sub_label": "Found",
53         "sources": [
54           {
55             "id": "id",
56             "type": "type",
57             "metadata": {
58               "key": "value"
59             }
60           }
61         ]
62       },
63       {
64         "category": "liens",
65         "key": "liens",
66         "label": "Liens",
67         "message": "No Liens found",
68         "name": "liens",
69         "status": "success",
70         "sub_label": "No Liens",
71         "sources": [
72           {
73             "id": "id",
74             "type": "type",
75             "metadata": {
76               "key": "value"
77             }
78           }
79         ]
80       },
81       {
82         "category": "name",
83         "key": "name",
84         "label": "Business Name",
85         "message": "Match identified to the submitted Business Name",
86         "name": "name",
87         "status": "success",
88         "sub_label": "Verified",
89         "sources": [
90           {
91             "id": "764682dd-bf80-4426-910c-9850531fc86c",
92             "type": "name",
93             "metadata": {
94               "name": "Agent",
95               "submitted": true
96             }
97           }
98         ]
99       },
100       {
101         "category": "address",
102         "key": "address_verification",
103         "label": "Office Address",
104         "message": "Match identified to the submitted Office Address",
105         "name": "address",
106         "status": "success",
107         "sub_label": "Verified",
108         "sources": [
109           {
110             "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
111             "type": "address",
112             "metadata": {
113               "city": "Phoenix",
114               "state": "AZ",
115               "submitted": true,
116               "postal_code": "85001",
117               "full_address": "369 Willow St, Phoenix, AZ 85001",
118               "address_line1": "369 Willow St"
119             }
120           }
121         ]
122       },
123       {
124         "category": "address",
125         "key": "address_deliverability",
126         "label": "Office Address",
127         "message": "The USPS is able to deliver mail to the submitted Office Address",
128         "name": "address",
129         "status": "success",
130         "sub_label": "Deliverable",
131         "sources": [
132           {
133             "id": "id",
134             "type": "type",
135             "metadata": {
136               "key": "value"
137             }
138           }
139         ]
140       },
141       {
142         "category": "address",
143         "key": "address_property_type",
144         "label": "Office Address",
145         "message": "Submitted Office Address is a Commercial property",
146         "name": "address",
147         "status": "success",
148         "sub_label": "Commercial",
149         "sources": [
150           {
151             "id": "id",
152             "type": "type",
153             "metadata": {
154               "key": "value"
155             }
156           }
157         ]
158       },
159       {
160         "category": "address",
161         "key": "location_frequency",
162         "label": "Office Address",
163         "message": "1 business uses this location",
164         "name": "address",
165         "status": "success",
166         "sub_label": "Low frequency",
167         "sources": [
168           {
169             "id": "id",
170             "type": "type",
171             "metadata": {
172               "key": "value"
173             }
174           }
175         ]
176       },
177       {
178         "category": "address",
179         "key": "address_risk",
180         "label": "Address Risk",
181         "message": "Address risk is low",
182         "name": "address",
183         "status": "success",
184         "sub_label": "Low",
185         "sources": [
186           {
187             "id": "id",
188             "type": "type",
189             "metadata": {
190               "key": "value"
191             }
192           }
193         ]
194       },
195       {
196         "category": "sos",
197         "key": "sos_match",
198         "label": "SOS Filings",
199         "message": "The business is Active in the state of the submitted Office Address",
200         "name": "sos",
201         "status": "success",
202         "sub_label": "Submitted Active",
203         "sources": [
204           {
205             "id": "id",
206             "type": "type",
207             "metadata": {
208               "key": "value"
209             }
210           }
211         ]
212       },
213       {
214         "category": "sos",
215         "key": "sos_active",
216         "label": "SOS Filings",
217         "message": "2 of 2 filings are Active",
218         "name": "sos",
219         "status": "success",
220         "sub_label": "Active",
221         "sources": [
222           {
223             "id": "id",
224             "type": "type",
225             "metadata": {
226               "key": "value"
227             }
228           }
229         ]
230       },
231       {
232         "category": "sos",
233         "key": "sos_domestic_sub_status",
234         "label": "SOS Domestic Sub‑status",
235         "message": "The domestic registration is in Good Standing.",
236         "name": "sos",
237         "status": "success",
238         "sub_label": "Good Standing",
239         "sources": [
240           {
241             "id": "id",
242             "type": "type",
243             "metadata": {
244               "key": "value"
245             }
246           }
247         ]
248       },
249       {
250         "category": "sos",
251         "key": "sos_domestic",
252         "label": "SOS Filings",
253         "message": "Active domestic filing found",
254         "name": "sos",
255         "status": "success",
256         "sub_label": "Domestic Active",
257         "sources": [
258           {
259             "id": "id",
260             "type": "type",
261             "metadata": {
262               "key": "value"
263             }
264           }
265         ]
266       },
267       {
268         "category": "watchlist",
269         "key": "watchlist",
270         "label": "Watchlist",
271         "message": "No Watchlist hits were identified",
272         "name": "watchlist",
273         "status": "success",
274         "sub_label": "No Hits",
275         "sources": [
276           {
277             "id": "id",
278             "type": "type",
279             "metadata": {
280               "key": "value"
281             }
282           }
283         ]
284       },
285       {
286         "category": "bankruptcies",
287         "key": "bankruptcies",
288         "label": "Bankruptcies",
289         "message": "The business has no bankruptcy filings",
290         "name": "bankruptcies",
291         "status": "success",
292         "sub_label": "None Found",
293         "sources": [
294           {
295             "id": "id",
296             "type": "type",
297             "metadata": {
298               "key": "value"
299             }
300           }
301         ]
302       }
303     ],
304     "assignee": {
305       "object": "user",
306       "id": "454913d6-2f79-4fc0-9234-4443f253af3c",
307       "name": "John Doe",
308       "email": "[email protected]",
309       "roles": [
310         "admin",
311         "member"
312       ],
313       "created_at": "2024-09-17T18:08:00Z",
314       "image_url": "https://www.gravatar.com/avatar/fa4fe13fa938ade11d07571178575ccf?s=64&d=https%3A%2F%2Fapp-sandbox.middesk.com%2Fimages%2Fdefault-avatar.png",
315       "directory_managed": false,
316       "last_login_at": "2024-09-20T16:24:39Z",
317       "settings": {
318         "receives_agent_emails": false
319       }
320     }
321   },
322   "tin": {
323     "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
324     "tin": "12-3456789",
325     "name": "Agent",
326     "mismatch": false,
327     "unknown": true,
328     "verified": false,
329     "updated_at": "2025-11-05T01:57:43Z",
330     "issued": true
331   },
332   "formation": {
333     "created_at": "2025-11-05T01:57:43Z",
334     "updated_at": "2025-11-05T01:57:43Z",
335     "entity_type": "AGENT",
336     "formation_date": "2020-02-24",
337     "formation_state": "AZ",
338     "sources": [
339       {
340         "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
341         "type": "registration",
342         "metadata": {
343           "state": "AZ",
344           "status": "active",
345           "file_number": "FN-XXXXXXX",
346           "jurisdiction": "DOMESTIC"
347         }
348       }
349     ]
350   },
351   "watchlist": {
352     "object": "watchlist",
353     "id": "145cf041-cb0a-447a-ab2a-0d721688b126",
354     "hit_count": 0,
355     "agencies": [
356       {
357         "abbr": "OFAC",
358         "name": "Office of Foreign Assets Control",
359         "org": "U.S. Department of Treasury"
360       },
361       {
362         "abbr": "BIS",
363         "name": "Bureau of Industry and Security",
364         "org": "U.S. Department of Commerce"
365       },
366       {
367         "abbr": "DDTC",
368         "name": "Directorate of Defense Trade Controls",
369         "org": "U.S. Department of State"
370       },
371       {
372         "abbr": "ISN",
373         "name": "Bureau of International Security and Non-Proliferation",
374         "org": "U.S. Department of State"
375       }
376     ],
377     "lists": [
378       {
379         "object": "watchlist_source",
380         "agency": "Office of Foreign Assets Control",
381         "agency_abbr": "OFAC",
382         "organization": "U.S. Department of Treasury",
383         "title": "Capta List",
384         "abbr": "CAP",
385         "results": [
386           {
387             "object": "watchlist_result",
388             "id": "id",
389             "status": "status",
390             "entity_name": "entity_name",
391             "entity_aliases": [
392               "entity_aliases"
393             ],
394             "agency_information_url": "agency_information_url",
395             "agency_list_url": "agency_list_url"
396           }
397         ]
398       },
399       {
400         "object": "watchlist_source",
401         "agency": "Bureau of Industry and Security",
402         "agency_abbr": "BIS",
403         "organization": "U.S. Department of Commerce",
404         "title": "Denied Persons List",
405         "abbr": "DPL",
406         "results": [
407           {
408             "object": "watchlist_result",
409             "id": "id",
410             "status": "status",
411             "entity_name": "entity_name",
412             "entity_aliases": [
413               "entity_aliases"
414             ],
415             "agency_information_url": "agency_information_url",
416             "agency_list_url": "agency_list_url"
417           }
418         ]
419       },
420       {
421         "object": "watchlist_source",
422         "agency": "Directorate of Defense Trade Controls",
423         "agency_abbr": "DDTC",
424         "organization": "U.S. Department of State",
425         "title": "AECA/ITAR Debarred",
426         "abbr": "DTC",
427         "results": [
428           {
429             "object": "watchlist_result",
430             "id": "id",
431             "status": "status",
432             "entity_name": "entity_name",
433             "entity_aliases": [
434               "entity_aliases"
435             ],
436             "agency_information_url": "agency_information_url",
437             "agency_list_url": "agency_list_url"
438           }
439         ]
440       },
441       {
442         "object": "watchlist_source",
443         "agency": "Bureau of Industry and Security",
444         "agency_abbr": "BIS",
445         "organization": "U.S. Department of Commerce",
446         "title": "Entity List",
447         "abbr": "EL",
448         "results": [
449           {
450             "object": "watchlist_result",
451             "id": "id",
452             "status": "status",
453             "entity_name": "entity_name",
454             "entity_aliases": [
455               "entity_aliases"
456             ],
457             "agency_information_url": "agency_information_url",
458             "agency_list_url": "agency_list_url"
459           }
460         ]
461       },
462       {
463         "object": "watchlist_source",
464         "agency": "Office of Foreign Assets Control",
465         "agency_abbr": "OFAC",
466         "organization": "U.S. Department of Treasury",
467         "title": "Foreign Sanctions Evaders",
468         "abbr": "FSE",
469         "results": [
470           {
471             "object": "watchlist_result",
472             "id": "id",
473             "status": "status",
474             "entity_name": "entity_name",
475             "entity_aliases": [
476               "entity_aliases"
477             ],
478             "agency_information_url": "agency_information_url",
479             "agency_list_url": "agency_list_url"
480           }
481         ]
482       },
483       {
484         "object": "watchlist_source",
485         "agency": "Bureau of International Security and Non-Proliferation",
486         "agency_abbr": "ISN",
487         "organization": "U.S. Department of State",
488         "title": "Nonproliferation Sanctions",
489         "abbr": "ISN",
490         "results": [
491           {
492             "object": "watchlist_result",
493             "id": "id",
494             "status": "status",
495             "entity_name": "entity_name",
496             "entity_aliases": [
497               "entity_aliases"
498             ],
499             "agency_information_url": "agency_information_url",
500             "agency_list_url": "agency_list_url"
501           }
502         ]
503       },
504       {
505         "object": "watchlist_source",
506         "agency": "Bureau of Industry and Security",
507         "agency_abbr": "BIS",
508         "organization": "U.S. Department of Commerce",
509         "title": "Military End User",
510         "abbr": "MEU",
511         "results": [
512           {
513             "object": "watchlist_result",
514             "id": "id",
515             "status": "status",
516             "entity_name": "entity_name",
517             "entity_aliases": [
518               "entity_aliases"
519             ],
520             "agency_information_url": "agency_information_url",
521             "agency_list_url": "agency_list_url"
522           }
523         ]
524       },
525       {
526         "object": "watchlist_source",
527         "agency": "Office of Foreign Assets Control",
528         "agency_abbr": "OFAC",
529         "organization": "U.S. Department of Treasury",
530         "title": "Non-SDN Chinese Military-Industrial Complex Companies List",
531         "abbr": "NS-CMIC",
532         "results": [
533           {
534             "object": "watchlist_result",
535             "id": "id",
536             "status": "status",
537             "entity_name": "entity_name",
538             "entity_aliases": [
539               "entity_aliases"
540             ],
541             "agency_information_url": "agency_information_url",
542             "agency_list_url": "agency_list_url"
543           }
544         ]
545       },
546       {
547         "object": "watchlist_source",
548         "agency": "Office of Foreign Assets Control",
549         "agency_abbr": "OFAC",
550         "organization": "U.S. Department of Treasury",
551         "title": "Non-SDN Iranian Sanctions",
552         "abbr": "NS-ISA",
553         "results": [
554           {
555             "object": "watchlist_result",
556             "id": "id",
557             "status": "status",
558             "entity_name": "entity_name",
559             "entity_aliases": [
560               "entity_aliases"
561             ],
562             "agency_information_url": "agency_information_url",
563             "agency_list_url": "agency_list_url"
564           }
565         ]
566       },
567       {
568         "object": "watchlist_source",
569         "agency": "Office of Foreign Assets Control",
570         "agency_abbr": "OFAC",
571         "organization": "U.S. Department of Treasury",
572         "title": "Non-SDN Menu-Based Sanctions",
573         "abbr": "NS-MBS",
574         "results": [
575           {
576             "object": "watchlist_result",
577             "id": "id",
578             "status": "status",
579             "entity_name": "entity_name",
580             "entity_aliases": [
581               "entity_aliases"
582             ],
583             "agency_information_url": "agency_information_url",
584             "agency_list_url": "agency_list_url"
585           }
586         ]
587       },
588       {
589         "object": "watchlist_source",
590         "agency": "Office of Foreign Assets Control",
591         "agency_abbr": "OFAC",
592         "organization": "U.S. Department of Treasury",
593         "title": "Palestinian Legislative Council",
594         "abbr": "PLC",
595         "results": [
596           {
597             "object": "watchlist_result",
598             "id": "id",
599             "status": "status",
600             "entity_name": "entity_name",
601             "entity_aliases": [
602               "entity_aliases"
603             ],
604             "agency_information_url": "agency_information_url",
605             "agency_list_url": "agency_list_url"
606           }
607         ]
608       },
609       {
610         "object": "watchlist_source",
611         "agency": "Office of Foreign Assets Control",
612         "agency_abbr": "OFAC",
613         "organization": "U.S. Department of Treasury",
614         "title": "Specially Designated Nationals",
615         "abbr": "SDN",
616         "results": [
617           {
618             "object": "watchlist_result",
619             "id": "id",
620             "status": "status",
621             "entity_name": "entity_name",
622             "entity_aliases": [
623               "entity_aliases"
624             ],
625             "agency_information_url": "agency_information_url",
626             "agency_list_url": "agency_list_url"
627           }
628         ]
629       },
630       {
631         "object": "watchlist_source",
632         "agency": "Office of Foreign Assets Control",
633         "agency_abbr": "OFAC",
634         "organization": "U.S. Department of Treasury",
635         "title": "Sectoral Sanctions Identifications",
636         "abbr": "SSI",
637         "results": [
638           {
639             "object": "watchlist_result",
640             "id": "id",
641             "status": "status",
642             "entity_name": "entity_name",
643             "entity_aliases": [
644               "entity_aliases"
645             ],
646             "agency_information_url": "agency_information_url",
647             "agency_list_url": "agency_list_url"
648           }
649         ]
650       },
651       {
652         "object": "watchlist_source",
653         "agency": "Bureau of Industry and Security",
654         "agency_abbr": "BIS",
655         "organization": "U.S. Department of Commerce",
656         "title": "Unverified List",
657         "abbr": "UVL",
658         "results": [
659           {
660             "object": "watchlist_result",
661             "id": "id",
662             "status": "status",
663             "entity_name": "entity_name",
664             "entity_aliases": [
665               "entity_aliases"
666             ],
667             "agency_information_url": "agency_information_url",
668             "agency_list_url": "agency_list_url"
669           }
670         ]
671       }
672     ],
673     "people": [
674       {
675         "key": "value"
676       }
677     ]
678   },
679   "bankruptcies": [
680     {
681       "object": "bankruptcy",
682       "id": "id",
683       "business_id": "business_id",
684       "case_number": "case_number",
685       "case_updates": [
686         {}
687       ],
688       "chapter": 1.1,
689       "court": "court",
690       "filing_date": "2023-01-15",
691       "debtors": [
692         {}
693       ]
694     }
695   ],
696   "certifications": [
697     {
698       "object": "certification",
699       "name": "name",
700       "key": "key",
701       "certification_type": "federal",
702       "external_sources": [
703         {}
704       ],
705       "id": "id",
706       "business_id": "business_id",
707       "created_at": "2024-01-15T09:30:00Z",
708       "updated_at": "2024-01-15T09:30:00Z",
709       "entrance_date": "2024-01-15T09:30:00Z",
710       "exit_date": "2024-01-15T09:30:00Z",
711       "certification_id": "certification_id"
712     }
713   ],
714   "documents": [
715     {
716       "object": "document",
717       "id": "id",
718       "document_type": "document_type",
719       "filename": "filename",
720       "content_type": "application/pdf",
721       "size": 1,
722       "download_url": "download_url",
723       "created_at": "2024-01-15T09:30:00Z",
724       "filing_date": "2024-01-15T09:30:00Z",
725       "metadata": {
726         "key": "value"
727       }
728     }
729   ],
730   "liens": [
731     {
732       "object": "lien",
733       "type": "ucc",
734       "id": "id",
735       "business_id": "business_id",
736       "debtors": [
737         {}
738       ],
739       "secured_parties": [
740         {}
741       ],
742       "file_number": "file_number",
743       "state": "AL",
744       "status": "created",
745       "filing_date": "2023-01-15",
746       "status_category": "active",
747       "owner_id": "owner_id",
748       "owner_type": "owner_type",
749       "documents": [
750         {
751           "object": "document",
752           "id": "id",
753           "document_type": "document_type",
754           "filename": "filename",
755           "content_type": "application/pdf",
756           "size": 1,
757           "download_url": "download_url",
758           "created_at": "2024-01-15T09:30:00Z"
759         }
760       ],
761       "updated_date": "2023-01-15",
762       "lapse_date": "2023-01-15",
763       "collateral": "collateral",
764       "collateral_type": "Blanket",
765       "negative_pledge": true,
766       "confirmation_number": "confirmation_number",
767       "loan_principal_amount_cents": 1,
768       "source": "source",
769       "packet_number": "packet_number",
770       "lien_termination": {
771         "key": "value"
772       },
773       "liability_cents": 1,
774       "alternative_designation": "buyer_seller"
775     }
776   ],
777   "names": [
778     {
779       "object": "name",
780       "id": "764682dd-bf80-4426-910c-9850531fc86c",
781       "name": "Agent",
782       "submitted": true,
783       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
784       "sources": [
785         {
786           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
787           "type": "registration",
788           "metadata": {
789             "state": "AZ",
790             "status": "active",
791             "file_number": "FN-XXXXXXX",
792             "jurisdiction": "DOMESTIC"
793           }
794         }
795       ],
796       "type": "legal"
797     }
798   ],
799   "addresses": [
800     {
801       "object": "address",
802       "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
803       "full_address": "369 Willow St, Phoenix, AZ 85001",
804       "submitted": true,
805       "created_at": "2025-11-05T01:57:42Z",
806       "updated_at": "2025-11-05T01:57:42Z",
807       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
808       "sources": [
809         {
810           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
811           "type": "registration",
812           "metadata": {
813             "state": "AZ",
814             "status": "active",
815             "file_number": "FN-XXXXXXX",
816             "jurisdiction": "DOMESTIC"
817           }
818         }
819       ],
820       "rating": {
821         "risk_rating": "low",
822         "indicators": [
823           {
824             "type": "valid_us_address",
825             "name": "Valid US address",
826             "rating": "positive",
827             "value": "valid",
828             "description": "Valid"
829           },
830           {
831             "type": "deliverability",
832             "name": "Valid US address",
833             "rating": "positive",
834             "value": "deliverable",
835             "description": "Deliverable"
836           },
837           {
838             "type": "geographical_location",
839             "name": "Geographical location",
840             "rating": "positive",
841             "value": "us",
842             "description": "US"
843           },
844           {
845             "type": "registered_agent",
846             "name": "Valid US address",
847             "rating": "positive",
848             "value": "not_registered_agent",
849             "description": "Not a registered agent"
850           },
851           {
852             "type": "private_mailbox",
853             "name": "Private mailbox",
854             "rating": "positive",
855             "value": "not_private_mailbox",
856             "description": "Not a private mailbox"
857           },
858           {
859             "type": "location_frequency",
860             "name": "Location frequency",
861             "rating": "positive",
862             "value": "1_business",
863             "description": "1 business"
864           },
865           {
866             "type": "virtual_address",
867             "name": "Virtual address",
868             "rating": "positive",
869             "value": "not_virtual_address",
870             "description": "Not a virtual address"
871           }
872         ]
873       },
874       "address_line1": "369 Willow St",
875       "city": "Phoenix",
876       "state": "AZ",
877       "postal_code": "85001",
878       "latitude": 40.52,
879       "longitude": 30.4,
880       "deliverable": true,
881       "street_view_available": false,
882       "labels": [
883         "labels"
884       ],
885       "cmra": false,
886       "location_count": 1,
887       "is_registered_agent": false
888     },
889     {
890       "object": "address",
891       "id": "84852fca-bd75-4367-a089-03d67f8e7362",
892       "full_address": "354 Circle Court,Bronx, NY 10468",
893       "submitted": false,
894       "created_at": "2025-11-05T01:57:43Z",
895       "updated_at": "2025-11-05T01:57:43Z",
896       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
897       "sources": [
898         {
899           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
900           "type": "registration",
901           "metadata": {
902             "state": "AZ",
903             "status": "active",
904             "file_number": "FN-XXXXXXX",
905             "jurisdiction": "DOMESTIC"
906           }
907         }
908       ],
909       "rating": {
910         "risk_rating": "high",
911         "indicators": [
912           {
913             "type": "valid_us_address",
914             "name": "Valid US address",
915             "rating": "negative",
916             "value": "invalid",
917             "description": "Invalid"
918           },
919           {
920             "type": "deliverability",
921             "name": "Valid US address",
922             "rating": "positive",
923             "value": "deliverable",
924             "description": "Deliverable"
925           },
926           {
927             "type": "geographical_location",
928             "name": "Geographical location",
929             "rating": "negative",
930             "value": "unknown",
931             "description": "Unknown"
932           },
933           {
934             "type": "registered_agent",
935             "name": "Valid US address",
936             "rating": "neutral",
937             "value": "unknown",
938             "description": "Unknown"
939           },
940           {
941             "type": "private_mailbox",
942             "name": "Private mailbox",
943             "rating": "neutral",
944             "value": "unknown",
945             "description": "Unknown"
946           },
947           {
948             "type": "location_frequency",
949             "name": "Location frequency",
950             "rating": "positive",
951             "value": "1_business",
952             "description": "1 business"
953           },
954           {
955             "type": "property_type",
956             "name": "Valid US address",
957             "rating": "neutral",
958             "value": "unknown",
959             "description": "Unknown"
960           }
961         ]
962       },
963       "address_line1": "354 Circle Ct",
964       "city": "Bronx",
965       "state": "NY",
966       "postal_code": "10468",
967       "deliverable": true,
968       "labels": [
969         "labels"
970       ],
971       "cmra": false,
972       "location_count": 1,
973       "is_registered_agent": false
974     }
975   ],
976   "people": [
977     {
978       "object": "person",
979       "id": "id",
980       "name": "name",
981       "business_id": "business_id"
982     }
983   ],
984   "phone_numbers": [
985     {
986       "object": "phone_number",
987       "id": "id",
988       "number": "number",
989       "business_id": "business_id"
990     }
991   ],
992   "profiles": [
993     {
994       "object": "profile",
995       "id": "id",
996       "type": "facebook",
997       "url": "url",
998       "external_id": "external_id",
999       "rating": 1.1,
1000       "rating_count": 1
1001     }
1002   ],
1003   "registrations": [
1004     {
1005       "object": "registration",
1006       "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
1007       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1008       "name": "Agent",
1009       "status": "active",
1010       "jurisdiction": "DOMESTIC",
1011       "entity_type": "AGENT",
1012       "file_number": "FN-XXXXXXX",
1013       "state": "AZ",
1014       "sub_status": "GOOD_STANDING",
1015       "status_details": "Active-Good Standing",
1016       "addresses": [
1017         "369 WILLOW ST, PHOENIX, AZ 85001",
1018         "354 CIRCLE COURT,BRONX, NY 10468"
1019       ],
1020       "officers": [
1021         {
1022           "key": "value"
1023         }
1024       ],
1025       "registered_agent": {
1026         "key": "value"
1027       },
1028       "registration_date": "2020-02-24",
1029       "source": "https://ecorp.azcc.gov/BusinessSearch/BusinessInfo?entityNumber=FN-XXXXXXX"
1030     },
1031     {
1032       "object": "registration",
1033       "id": "69609259-dfec-4929-ba36-aca90f91b555",
1034       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1035       "name": "Agent",
1036       "status": "active",
1037       "jurisdiction": "FOREIGN",
1038       "entity_type": "AGENT",
1039       "file_number": "12345135135",
1040       "state": "CO",
1041       "addresses": [
1042         "369 WILLOW ST, PHOENIX, AZ 85001",
1043         "354 CIRCLE COURT,BRONX, NY 10468"
1044       ],
1045       "officers": [
1046         {
1047           "key": "value"
1048         }
1049       ],
1050       "registered_agent": {
1051         "key": "value"
1052       },
1053       "registration_date": "2020-02-24",
1054       "source": "https://www.sos.state.co.us/biz/BusinessEntityCriteriaExt.do"
1055     }
1056   ],
1057   "orders": [
1058     {
1059       "object": "order",
1060       "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7",
1061       "package": "business_verification_verify",
1062       "status": "completed",
1063       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1064       "created_at": "2025-11-05T01:57:42Z",
1065       "updated_at": "2025-11-05T01:57:44Z",
1066       "subproducts": [
1067         "articles_of_incorporation"
1068       ]
1069     },
1070     {
1071       "object": "order",
1072       "id": "bca42881-ed2a-4de9-84c3-25795e280bf3",
1073       "package": "tax_liens",
1074       "status": "completed",
1075       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1076       "created_at": "2025-11-05T01:57:42Z",
1077       "updated_at": "2025-11-05T01:57:44Z",
1078       "subproducts": [
1079         "articles_of_incorporation"
1080       ]
1081     },
1082     {
1083       "object": "order",
1084       "id": "6e71a276-ebf4-4396-b091-3e13251a25c6",
1085       "package": "litigations",
1086       "status": "completed",
1087       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1088       "created_at": "2025-11-05T01:57:42Z",
1089       "updated_at": "2025-11-05T01:57:44Z",
1090       "subproducts": [
1091         "articles_of_incorporation"
1092       ]
1093     },
1094     {
1095       "object": "order",
1096       "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140",
1097       "package": "bankruptcies",
1098       "status": "completed",
1099       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1100       "created_at": "2025-11-05T01:57:42Z",
1101       "updated_at": "2025-11-05T01:57:44Z",
1102       "subproducts": [
1103         "articles_of_incorporation"
1104       ]
1105     },
1106     {
1107       "object": "order",
1108       "id": "1276547b-1cca-416f-b451-22e4a24c25fb",
1109       "package": "ucc_liens",
1110       "status": "completed",
1111       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1112       "created_at": "2025-11-05T01:57:42Z",
1113       "updated_at": "2025-11-05T01:57:44Z",
1114       "subproducts": [
1115         "articles_of_incorporation"
1116       ]
1117     }
1118   ],
1119   "fmcsa_registrations": [
1120     {
1121       "object": "fmcsa_registration",
1122       "id": "id",
1123       "dot_number": "dot_number",
1124       "legal_name": "legal_name",
1125       "source": "source",
1126       "addresses": [
1127         "addresses"
1128       ],
1129       "dba_name": "dba_name"
1130     }
1131   ],
1132   "litigations": [
1133     {
1134       "object": "litigation",
1135       "id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1136       "case_name": "ABC RECOVERY ASSOCIATES, LLC Et Al VS PAT RANDOM",
1137       "case_number": "GV22001014-00",
1138       "case_status": "CLOSED",
1139       "case_type": "Property",
1140       "filing_date": "2022-07-29",
1141       "party_type": "PLAINTIFF",
1142       "judgments": [
1143         {
1144           "id": "18c7e62b-5897-47c4-b583-037614ab2a40",
1145           "litigation_id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1146           "docket_entry_date": "2001-05-01",
1147           "text": "Judgment",
1148           "created_at": "2025-11-05T01:57:43Z",
1149           "updated_at": "2025-11-05T01:57:43Z"
1150         }
1151       ],
1152       "jurisdiction": "Bedford General District Court",
1153       "jurisdiction_state": "Virginia"
1154     },
1155     {
1156       "object": "litigation",
1157       "id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1158       "case_name": "XYZ RECOVERY ASSOCIATES LLC ASSIGNEE VS PAT RANDOM",
1159       "case_number": "GV22007165-00",
1160       "case_status": "OPEN",
1161       "case_type": "Contract",
1162       "filing_date": "2025-11-05",
1163       "party_type": "DEFENDANT",
1164       "judgments": [
1165         {
1166           "id": "93b5bedf-dab9-4246-be74-d49343d1f2a2",
1167           "litigation_id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1168           "docket_entry_date": "2001-05-01",
1169           "text": "Judgment: Parties For: Schmoe, Joe; Against: X.Com;",
1170           "created_at": "2025-11-05T01:57:43Z",
1171           "updated_at": "2025-11-05T01:57:43Z"
1172         }
1173       ],
1174       "jurisdiction": "Hampton General District Court",
1175       "jurisdiction_state": "Virginia"
1176     },
1177     {
1178       "object": "litigation",
1179       "id": "12127ea6-b177-4d4c-b270-ee2c87952a6e",
1180       "case_name": "ABC CAPITAL BANK/BEST NEO BANK Et Al VS PAT RANDOM",
1181       "case_number": "GV22007158-00",
1182       "case_status": "UNKNOWN",
1183       "case_type": "Civil",
1184       "filing_date": "2022-07-28",
1185       "party_type": "UNKNOWN",
1186       "judgments": [
1187         {
1188           "id": "id",
1189           "litigation_id": "litigation_id",
1190           "docket_entry_date": "2023-01-15",
1191           "text": "text",
1192           "created_at": "2024-01-15T09:30:00Z",
1193           "updated_at": "2024-01-15T09:30:00Z"
1194         }
1195       ],
1196       "jurisdiction": "UNKNOWN"
1197     }
1198   ],
1199   "policy_results": [
1200     {
1201       "object": "policy_result",
1202       "id": "id",
1203       "result": "result",
1204       "created_at": "created_at",
1205       "matched": "matched",
1206       "executed": true,
1207       "name": "name",
1208       "details": {
1209         "key": "value"
1210       },
1211       "owner_id": "owner_id",
1212       "owner_type": "owner_type",
1213       "business_id": "business_id",
1214       "type_of": "type_of",
1215       "policy_action_results": [
1216         {
1217           "object": "policy_action_result"
1218         }
1219       ]
1220     }
1221   ],
1222   "submitted": {
1223     "object": "submitted_attributes",
1224     "name": "Agent",
1225     "addresses": [
1226       {
1227         "full_address": "369 Willow St, Phoenix, AZ 85001"
1228       }
1229     ],
1230     "orders": [
1231       "orders"
1232     ],
1233     "people": [
1234       {
1235         "key": "value"
1236       }
1237     ],
1238     "phone_numbers": [
1239       {
1240         "key": "value"
1241       }
1242     ],
1243     "email_addresses": [
1244       {
1245         "key": "value"
1246       }
1247     ],
1248     "tin": {
1249       "tin": "123456789"
1250     },
1251     "website": {
1252       "key": "value"
1253     },
1254     "profiles": [
1255       {
1256         "key": "value"
1257       }
1258     ]
1259   }
1260 }

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Business ID

Response

business found

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 strings

reviewobject or null

tinobject or null

business_batch_idstring or null

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

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

Errors

404

Get V1businesses ID Request Not Found Error