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": "Basic <username>:<password>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

Try it

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": "example@example.com",
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             "key": "value"
388           }
389         ]
390       },
391       {
392         "object": "watchlist_source",
393         "agency": "Bureau of Industry and Security",
394         "agency_abbr": "BIS",
395         "organization": "U.S. Department of Commerce",
396         "title": "Denied Persons List",
397         "abbr": "DPL",
398         "results": [
399           {
400             "key": "value"
401           }
402         ]
403       },
404       {
405         "object": "watchlist_source",
406         "agency": "Directorate of Defense Trade Controls",
407         "agency_abbr": "DDTC",
408         "organization": "U.S. Department of State",
409         "title": "AECA/ITAR Debarred",
410         "abbr": "DTC",
411         "results": [
412           {
413             "key": "value"
414           }
415         ]
416       },
417       {
418         "object": "watchlist_source",
419         "agency": "Bureau of Industry and Security",
420         "agency_abbr": "BIS",
421         "organization": "U.S. Department of Commerce",
422         "title": "Entity List",
423         "abbr": "EL",
424         "results": [
425           {
426             "key": "value"
427           }
428         ]
429       },
430       {
431         "object": "watchlist_source",
432         "agency": "Office of Foreign Assets Control",
433         "agency_abbr": "OFAC",
434         "organization": "U.S. Department of Treasury",
435         "title": "Foreign Sanctions Evaders",
436         "abbr": "FSE",
437         "results": [
438           {
439             "key": "value"
440           }
441         ]
442       },
443       {
444         "object": "watchlist_source",
445         "agency": "Bureau of International Security and Non-Proliferation",
446         "agency_abbr": "ISN",
447         "organization": "U.S. Department of State",
448         "title": "Nonproliferation Sanctions",
449         "abbr": "ISN",
450         "results": [
451           {
452             "key": "value"
453           }
454         ]
455       },
456       {
457         "object": "watchlist_source",
458         "agency": "Bureau of Industry and Security",
459         "agency_abbr": "BIS",
460         "organization": "U.S. Department of Commerce",
461         "title": "Military End User",
462         "abbr": "MEU",
463         "results": [
464           {
465             "key": "value"
466           }
467         ]
468       },
469       {
470         "object": "watchlist_source",
471         "agency": "Office of Foreign Assets Control",
472         "agency_abbr": "OFAC",
473         "organization": "U.S. Department of Treasury",
474         "title": "Non-SDN Chinese Military-Industrial Complex Companies List",
475         "abbr": "NS-CMIC",
476         "results": [
477           {
478             "key": "value"
479           }
480         ]
481       },
482       {
483         "object": "watchlist_source",
484         "agency": "Office of Foreign Assets Control",
485         "agency_abbr": "OFAC",
486         "organization": "U.S. Department of Treasury",
487         "title": "Non-SDN Iranian Sanctions",
488         "abbr": "NS-ISA",
489         "results": [
490           {
491             "key": "value"
492           }
493         ]
494       },
495       {
496         "object": "watchlist_source",
497         "agency": "Office of Foreign Assets Control",
498         "agency_abbr": "OFAC",
499         "organization": "U.S. Department of Treasury",
500         "title": "Non-SDN Menu-Based Sanctions",
501         "abbr": "NS-MBS",
502         "results": [
503           {
504             "key": "value"
505           }
506         ]
507       },
508       {
509         "object": "watchlist_source",
510         "agency": "Office of Foreign Assets Control",
511         "agency_abbr": "OFAC",
512         "organization": "U.S. Department of Treasury",
513         "title": "Palestinian Legislative Council",
514         "abbr": "PLC",
515         "results": [
516           {
517             "key": "value"
518           }
519         ]
520       },
521       {
522         "object": "watchlist_source",
523         "agency": "Office of Foreign Assets Control",
524         "agency_abbr": "OFAC",
525         "organization": "U.S. Department of Treasury",
526         "title": "Specially Designated Nationals",
527         "abbr": "SDN",
528         "results": [
529           {
530             "key": "value"
531           }
532         ]
533       },
534       {
535         "object": "watchlist_source",
536         "agency": "Office of Foreign Assets Control",
537         "agency_abbr": "OFAC",
538         "organization": "U.S. Department of Treasury",
539         "title": "Sectoral Sanctions Identifications",
540         "abbr": "SSI",
541         "results": [
542           {
543             "key": "value"
544           }
545         ]
546       },
547       {
548         "object": "watchlist_source",
549         "agency": "Bureau of Industry and Security",
550         "agency_abbr": "BIS",
551         "organization": "U.S. Department of Commerce",
552         "title": "Unverified List",
553         "abbr": "UVL",
554         "results": [
555           {
556             "key": "value"
557           }
558         ]
559       }
560     ],
561     "people": [
562       {
563         "key": "value"
564       }
565     ]
566   },
567   "bankruptcies": [
568     {
569       "object": "bankruptcy",
570       "id": "id",
571       "business_id": "business_id",
572       "case_number": "case_number",
573       "case_updates": [
574         {}
575       ],
576       "chapter": 1.1,
577       "court": "court",
578       "filing_date": "2023-01-15",
579       "debtors": [
580         {}
581       ]
582     }
583   ],
584   "certifications": [
585     {
586       "object": "certification",
587       "name": "name",
588       "key": "key",
589       "certification_type": "federal",
590       "external_sources": [
591         {}
592       ],
593       "id": "id",
594       "business_id": "business_id",
595       "created_at": "2024-01-15T09:30:00Z",
596       "updated_at": "2024-01-15T09:30:00Z",
597       "entrance_date": "2024-01-15T09:30:00Z",
598       "exit_date": "2024-01-15T09:30:00Z",
599       "certification_id": "certification_id"
600     }
601   ],
602   "documents": [
603     {
604       "object": "document",
605       "id": "id",
606       "document_type": "document_type",
607       "filename": "filename",
608       "content_type": "application/pdf",
609       "size": 1,
610       "download_url": "download_url",
611       "created_at": "2024-01-15T09:30:00Z",
612       "filing_date": "2024-01-15T09:30:00Z",
613       "metadata": {
614         "key": "value"
615       }
616     }
617   ],
618   "liens": [
619     {
620       "object": "lien",
621       "type": "ucc",
622       "id": "id",
623       "business_id": "business_id",
624       "debtors": [
625         {}
626       ],
627       "secured_parties": [
628         {}
629       ],
630       "file_number": "file_number",
631       "state": "AL",
632       "status": "created",
633       "filing_date": "2023-01-15",
634       "status_category": "active",
635       "owner_id": "owner_id",
636       "owner_type": "owner_type",
637       "documents": [
638         {
639           "object": "document",
640           "id": "id",
641           "document_type": "document_type",
642           "filename": "filename",
643           "content_type": "application/pdf",
644           "size": 1,
645           "download_url": "download_url",
646           "created_at": "2024-01-15T09:30:00Z"
647         }
648       ],
649       "updated_date": "2023-01-15",
650       "lapse_date": "2023-01-15",
651       "collateral": "collateral",
652       "collateral_type": "Blanket",
653       "negative_pledge": true,
654       "confirmation_number": "confirmation_number",
655       "loan_principal_amount_cents": 1,
656       "source": "source",
657       "packet_number": "packet_number",
658       "lien_termination": {
659         "key": "value"
660       },
661       "liability_cents": 1,
662       "alternative_designation": "buyer_seller"
663     }
664   ],
665   "names": [
666     {
667       "object": "name",
668       "id": "764682dd-bf80-4426-910c-9850531fc86c",
669       "name": "Agent",
670       "submitted": true,
671       "type": "legal",
672       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
673       "sources": [
674         {
675           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
676           "type": "registration",
677           "metadata": {
678             "state": "AZ",
679             "status": "active",
680             "file_number": "FN-XXXXXXX",
681             "jurisdiction": "DOMESTIC"
682           }
683         }
684       ]
685     }
686   ],
687   "addresses": [
688     {
689       "object": "address",
690       "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
691       "full_address": "369 Willow St, Phoenix, AZ 85001",
692       "submitted": true,
693       "created_at": "2025-11-05T01:57:42Z",
694       "updated_at": "2025-11-05T01:57:42Z",
695       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
696       "sources": [
697         {
698           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
699           "type": "registration",
700           "metadata": {
701             "state": "AZ",
702             "status": "active",
703             "file_number": "FN-XXXXXXX",
704             "jurisdiction": "DOMESTIC"
705           }
706         }
707       ],
708       "rating": {
709         "risk_rating": "low",
710         "indicators": [
711           {
712             "type": "valid_us_address",
713             "name": "Valid US address",
714             "rating": "positive",
715             "value": "valid",
716             "description": "Valid"
717           },
718           {
719             "type": "deliverability",
720             "name": "Valid US address",
721             "rating": "positive",
722             "value": "deliverable",
723             "description": "Deliverable"
724           },
725           {
726             "type": "geographical_location",
727             "name": "Geographical location",
728             "rating": "positive",
729             "value": "us",
730             "description": "US"
731           },
732           {
733             "type": "registered_agent",
734             "name": "Valid US address",
735             "rating": "positive",
736             "value": "not_registered_agent",
737             "description": "Not a registered agent"
738           },
739           {
740             "type": "private_mailbox",
741             "name": "Private mailbox",
742             "rating": "positive",
743             "value": "not_private_mailbox",
744             "description": "Not a private mailbox"
745           },
746           {
747             "type": "location_frequency",
748             "name": "Location frequency",
749             "rating": "positive",
750             "value": "1_business",
751             "description": "1 business"
752           },
753           {
754             "type": "virtual_address",
755             "name": "Virtual address",
756             "rating": "positive",
757             "value": "not_virtual_address",
758             "description": "Not a virtual address"
759           }
760         ]
761       },
762       "address_line1": "369 Willow St",
763       "city": "Phoenix",
764       "state": "AZ",
765       "postal_code": "85001",
766       "latitude": 40.52,
767       "longitude": 30.4,
768       "deliverable": true,
769       "street_view_available": false,
770       "labels": [
771         "labels"
772       ],
773       "cmra": false,
774       "location_count": 1,
775       "is_registered_agent": false
776     },
777     {
778       "object": "address",
779       "id": "84852fca-bd75-4367-a089-03d67f8e7362",
780       "full_address": "354 Circle Court,Bronx, NY 10468",
781       "submitted": false,
782       "created_at": "2025-11-05T01:57:43Z",
783       "updated_at": "2025-11-05T01:57:43Z",
784       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
785       "sources": [
786         {
787           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
788           "type": "registration",
789           "metadata": {
790             "state": "AZ",
791             "status": "active",
792             "file_number": "FN-XXXXXXX",
793             "jurisdiction": "DOMESTIC"
794           }
795         }
796       ],
797       "rating": {
798         "risk_rating": "high",
799         "indicators": [
800           {
801             "type": "valid_us_address",
802             "name": "Valid US address",
803             "rating": "negative",
804             "value": "invalid",
805             "description": "Invalid"
806           },
807           {
808             "type": "deliverability",
809             "name": "Valid US address",
810             "rating": "positive",
811             "value": "deliverable",
812             "description": "Deliverable"
813           },
814           {
815             "type": "geographical_location",
816             "name": "Geographical location",
817             "rating": "negative",
818             "value": "unknown",
819             "description": "Unknown"
820           },
821           {
822             "type": "registered_agent",
823             "name": "Valid US address",
824             "rating": "neutral",
825             "value": "unknown",
826             "description": "Unknown"
827           },
828           {
829             "type": "private_mailbox",
830             "name": "Private mailbox",
831             "rating": "neutral",
832             "value": "unknown",
833             "description": "Unknown"
834           },
835           {
836             "type": "location_frequency",
837             "name": "Location frequency",
838             "rating": "positive",
839             "value": "1_business",
840             "description": "1 business"
841           },
842           {
843             "type": "property_type",
844             "name": "Valid US address",
845             "rating": "neutral",
846             "value": "unknown",
847             "description": "Unknown"
848           }
849         ]
850       },
851       "address_line1": "354 Circle Ct",
852       "city": "Bronx",
853       "state": "NY",
854       "postal_code": "10468",
855       "deliverable": true,
856       "labels": [
857         "labels"
858       ],
859       "cmra": false,
860       "location_count": 1,
861       "is_registered_agent": false
862     }
863   ],
864   "people": [
865     {
866       "object": "person",
867       "id": "id",
868       "name": "name",
869       "business_id": "business_id"
870     }
871   ],
872   "phone_numbers": [
873     {
874       "object": "phone_number",
875       "id": "id",
876       "number": "number",
877       "business_id": "business_id"
878     }
879   ],
880   "profiles": [
881     {
882       "object": "profile",
883       "id": "id"
884     }
885   ],
886   "registrations": [
887     {
888       "object": "registration",
889       "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
890       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
891       "name": "Agent",
892       "status": "active",
893       "jurisdiction": "DOMESTIC",
894       "entity_type": "AGENT",
895       "file_number": "FN-XXXXXXX",
896       "state": "AZ",
897       "sub_status": "GOOD_STANDING",
898       "status_details": "Active-Good Standing",
899       "addresses": [
900         "369 WILLOW ST, PHOENIX, AZ 85001",
901         "354 CIRCLE COURT,BRONX, NY 10468"
902       ],
903       "officers": [
904         {
905           "key": "value"
906         }
907       ],
908       "registered_agent": {
909         "key": "value"
910       },
911       "registration_date": "2020-02-24",
912       "source": "https://ecorp.azcc.gov/BusinessSearch/BusinessInfo?entityNumber=FN-XXXXXXX"
913     },
914     {
915       "object": "registration",
916       "id": "69609259-dfec-4929-ba36-aca90f91b555",
917       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
918       "name": "Agent",
919       "status": "active",
920       "jurisdiction": "FOREIGN",
921       "entity_type": "AGENT",
922       "file_number": "12345135135",
923       "state": "CO",
924       "addresses": [
925         "369 WILLOW ST, PHOENIX, AZ 85001",
926         "354 CIRCLE COURT,BRONX, NY 10468"
927       ],
928       "officers": [
929         {
930           "key": "value"
931         }
932       ],
933       "registered_agent": {
934         "key": "value"
935       },
936       "registration_date": "2020-02-24",
937       "source": "https://www.sos.state.co.us/biz/BusinessEntityCriteriaExt.do"
938     }
939   ],
940   "orders": [
941     {
942       "object": "order",
943       "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7",
944       "package": "business_verification_verify",
945       "status": "completed",
946       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
947       "created_at": "2025-11-05T01:57:42Z",
948       "updated_at": "2025-11-05T01:57:44Z",
949       "subproducts": [
950         "articles_of_incorporation"
951       ]
952     },
953     {
954       "object": "order",
955       "id": "bca42881-ed2a-4de9-84c3-25795e280bf3",
956       "package": "tax_liens",
957       "status": "completed",
958       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
959       "created_at": "2025-11-05T01:57:42Z",
960       "updated_at": "2025-11-05T01:57:44Z",
961       "subproducts": [
962         "articles_of_incorporation"
963       ]
964     },
965     {
966       "object": "order",
967       "id": "6e71a276-ebf4-4396-b091-3e13251a25c6",
968       "package": "litigations",
969       "status": "completed",
970       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
971       "created_at": "2025-11-05T01:57:42Z",
972       "updated_at": "2025-11-05T01:57:44Z",
973       "subproducts": [
974         "articles_of_incorporation"
975       ]
976     },
977     {
978       "object": "order",
979       "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140",
980       "package": "bankruptcies",
981       "status": "completed",
982       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
983       "created_at": "2025-11-05T01:57:42Z",
984       "updated_at": "2025-11-05T01:57:44Z",
985       "subproducts": [
986         "articles_of_incorporation"
987       ]
988     },
989     {
990       "object": "order",
991       "id": "1276547b-1cca-416f-b451-22e4a24c25fb",
992       "package": "ucc_liens",
993       "status": "completed",
994       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
995       "created_at": "2025-11-05T01:57:42Z",
996       "updated_at": "2025-11-05T01:57:44Z",
997       "subproducts": [
998         "articles_of_incorporation"
999       ]
1000     }
1001   ],
1002   "fmcsa_registrations": [
1003     {
1004       "object": "fmcsa_registration",
1005       "id": "id",
1006       "dot_number": "dot_number",
1007       "legal_name": "legal_name",
1008       "source": "source",
1009       "addresses": [
1010         "addresses"
1011       ],
1012       "dba_name": "dba_name"
1013     }
1014   ],
1015   "litigations": [
1016     {
1017       "object": "litigation",
1018       "id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1019       "case_name": "ABC RECOVERY ASSOCIATES, LLC Et Al VS PAT RANDOM",
1020       "case_number": "GV22001014-00",
1021       "case_status": "CLOSED",
1022       "case_type": "Property",
1023       "filing_date": "2022-07-29",
1024       "party_type": "PLAINTIFF",
1025       "judgments": [
1026         {
1027           "id": "18c7e62b-5897-47c4-b583-037614ab2a40",
1028           "litigation_id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1029           "docket_entry_date": "2001-05-01",
1030           "text": "Judgment",
1031           "created_at": "2025-11-05T01:57:43Z",
1032           "updated_at": "2025-11-05T01:57:43Z"
1033         }
1034       ],
1035       "jurisdiction": "Bedford General District Court",
1036       "jurisdiction_state": "Virginia"
1037     },
1038     {
1039       "object": "litigation",
1040       "id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1041       "case_name": "XYZ RECOVERY ASSOCIATES LLC ASSIGNEE VS PAT RANDOM",
1042       "case_number": "GV22007165-00",
1043       "case_status": "OPEN",
1044       "case_type": "Contract",
1045       "filing_date": "2025-11-05",
1046       "party_type": "DEFENDANT",
1047       "judgments": [
1048         {
1049           "id": "93b5bedf-dab9-4246-be74-d49343d1f2a2",
1050           "litigation_id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1051           "docket_entry_date": "2001-05-01",
1052           "text": "Judgment: Parties For: Schmoe, Joe; Against: X.Com;",
1053           "created_at": "2025-11-05T01:57:43Z",
1054           "updated_at": "2025-11-05T01:57:43Z"
1055         }
1056       ],
1057       "jurisdiction": "Hampton General District Court",
1058       "jurisdiction_state": "Virginia"
1059     },
1060     {
1061       "object": "litigation",
1062       "id": "12127ea6-b177-4d4c-b270-ee2c87952a6e",
1063       "case_name": "ABC CAPITAL BANK/BEST NEO BANK Et Al VS PAT RANDOM",
1064       "case_number": "GV22007158-00",
1065       "case_status": "UNKNOWN",
1066       "case_type": "Civil",
1067       "filing_date": "2022-07-28",
1068       "party_type": "UNKNOWN",
1069       "judgments": [
1070         {
1071           "id": "id",
1072           "litigation_id": "litigation_id",
1073           "docket_entry_date": "2023-01-15",
1074           "text": "text",
1075           "created_at": "2024-01-15T09:30:00Z",
1076           "updated_at": "2024-01-15T09:30:00Z"
1077         }
1078       ],
1079       "jurisdiction": "UNKNOWN"
1080     }
1081   ],
1082   "actions": [
1083     {
1084       "object": "action",
1085       "id": "id"
1086     }
1087   ],
1088   "policy_results": [
1089     {
1090       "object": "policy_result",
1091       "id": "id",
1092       "result": "result",
1093       "created_at": "created_at",
1094       "matched": "matched",
1095       "executed": true,
1096       "name": "name",
1097       "details": {
1098         "key": "value"
1099       },
1100       "owner_id": "owner_id",
1101       "owner_type": "owner_type",
1102       "business_id": "business_id",
1103       "type_of": "type_of",
1104       "policy_action_results": [
1105         {
1106           "object": "policy_action_result"
1107         }
1108       ]
1109     }
1110   ],
1111   "submitted": {
1112     "object": "submitted_attributes",
1113     "name": "Agent",
1114     "addresses": [
1115       {
1116         "full_address": "369 Willow St, Phoenix, AZ 85001"
1117       }
1118     ],
1119     "orders": [
1120       "orders"
1121     ],
1122     "people": [
1123       {
1124         "key": "value"
1125       }
1126     ],
1127     "phone_numbers": [
1128       {
1129         "key": "value"
1130       }
1131     ],
1132     "email_addresses": [
1133       {
1134         "key": "value"
1135       }
1136     ],
1137     "tin": {
1138       "tin": "123456789"
1139     },
1140     "website": {
1141       "key": "value"
1142     },
1143     "profiles": [
1144       {
1145         "key": "value"
1146       }
1147     ]
1148   }
1149 }

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

Path parameters

idstringRequired

Business ID

Response

business found

objectstring

idstringformat: "uuid"

namestring

statusenum

Current status of the business verification

Allowed values:

created_atdatetime

updated_atdatetime

external_idstring or null

unique_external_idstring or null

tagslist of strings or null

requesterobject or null

assignee_idstring or nullformat: "uuid"

supported_document_typeslist of strings or null

reviewobject or null

tinobject or null

business_batch_idstring or null

formationobject or null

websiteobject or null

watchlistobject or null

bankruptcieslist of objects or null

certificationslist of objects or null

documentslist of objects or null

lienslist of objects or null

nameslist of objects or null

addresseslist of objects or null

peoplelist of objects or null

phone_numberslist of objects or null

profileslist of objects or null

registrationslist of objects or null

orderslist of objects or null

industry_classificationobject or null

monitorobject or null

tax_exempt_organizationobject or null

fmcsa_registrationslist of objects or null

litigationslist of objects or null

actionslist of objects or null

policy_resultslist of objects or null

politically_exposed_person_screeningobject or null

adverse_media_screeningobject or null

signalobject or null

submittedobject or null

subscriptionobject or null

Authentication

Path parameters

Response

Errors