Retrieve a business

GET

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

GET

/v1/businesses/:id

$ curl https://api.middesk.com/v1/businesses/id \
>      -H "Authorization: Bearer <token>"

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               "address_line1": "369 Willow St",
114               "city": "Phoenix",
115               "full_address": "369 Willow St, Phoenix, AZ 85001",
116               "postal_code": "85001",
117               "state": "AZ",
118               "submitted": true
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           "file_number": "FN-XXXXXXX",
344           "jurisdiction": "DOMESTIC",
345           "state": "AZ",
346           "status": "active"
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             "score": null
397           }
398         ]
399       },
400       {
401         "object": "watchlist_source",
402         "agency": "Bureau of Industry and Security",
403         "agency_abbr": "BIS",
404         "organization": "U.S. Department of Commerce",
405         "title": "Denied Persons List",
406         "abbr": "DPL",
407         "results": [
408           {
409             "object": "watchlist_result",
410             "id": "id",
411             "status": "status",
412             "entity_name": "entity_name",
413             "entity_aliases": [
414               "entity_aliases"
415             ],
416             "agency_information_url": "agency_information_url",
417             "agency_list_url": "agency_list_url",
418             "score": null
419           }
420         ]
421       },
422       {
423         "object": "watchlist_source",
424         "agency": "Directorate of Defense Trade Controls",
425         "agency_abbr": "DDTC",
426         "organization": "U.S. Department of State",
427         "title": "AECA/ITAR Debarred",
428         "abbr": "DTC",
429         "results": [
430           {
431             "object": "watchlist_result",
432             "id": "id",
433             "status": "status",
434             "entity_name": "entity_name",
435             "entity_aliases": [
436               "entity_aliases"
437             ],
438             "agency_information_url": "agency_information_url",
439             "agency_list_url": "agency_list_url",
440             "score": null
441           }
442         ]
443       },
444       {
445         "object": "watchlist_source",
446         "agency": "Bureau of Industry and Security",
447         "agency_abbr": "BIS",
448         "organization": "U.S. Department of Commerce",
449         "title": "Entity List",
450         "abbr": "EL",
451         "results": [
452           {
453             "object": "watchlist_result",
454             "id": "id",
455             "status": "status",
456             "entity_name": "entity_name",
457             "entity_aliases": [
458               "entity_aliases"
459             ],
460             "agency_information_url": "agency_information_url",
461             "agency_list_url": "agency_list_url",
462             "score": null
463           }
464         ]
465       },
466       {
467         "object": "watchlist_source",
468         "agency": "Office of Foreign Assets Control",
469         "agency_abbr": "OFAC",
470         "organization": "U.S. Department of Treasury",
471         "title": "Foreign Sanctions Evaders",
472         "abbr": "FSE",
473         "results": [
474           {
475             "object": "watchlist_result",
476             "id": "id",
477             "status": "status",
478             "entity_name": "entity_name",
479             "entity_aliases": [
480               "entity_aliases"
481             ],
482             "agency_information_url": "agency_information_url",
483             "agency_list_url": "agency_list_url",
484             "score": null
485           }
486         ]
487       },
488       {
489         "object": "watchlist_source",
490         "agency": "Bureau of International Security and Non-Proliferation",
491         "agency_abbr": "ISN",
492         "organization": "U.S. Department of State",
493         "title": "Nonproliferation Sanctions",
494         "abbr": "ISN",
495         "results": [
496           {
497             "object": "watchlist_result",
498             "id": "id",
499             "status": "status",
500             "entity_name": "entity_name",
501             "entity_aliases": [
502               "entity_aliases"
503             ],
504             "agency_information_url": "agency_information_url",
505             "agency_list_url": "agency_list_url",
506             "score": null
507           }
508         ]
509       },
510       {
511         "object": "watchlist_source",
512         "agency": "Bureau of Industry and Security",
513         "agency_abbr": "BIS",
514         "organization": "U.S. Department of Commerce",
515         "title": "Military End User",
516         "abbr": "MEU",
517         "results": [
518           {
519             "object": "watchlist_result",
520             "id": "id",
521             "status": "status",
522             "entity_name": "entity_name",
523             "entity_aliases": [
524               "entity_aliases"
525             ],
526             "agency_information_url": "agency_information_url",
527             "agency_list_url": "agency_list_url",
528             "score": null
529           }
530         ]
531       },
532       {
533         "object": "watchlist_source",
534         "agency": "Office of Foreign Assets Control",
535         "agency_abbr": "OFAC",
536         "organization": "U.S. Department of Treasury",
537         "title": "Non-SDN Chinese Military-Industrial Complex Companies List",
538         "abbr": "NS-CMIC",
539         "results": [
540           {
541             "object": "watchlist_result",
542             "id": "id",
543             "status": "status",
544             "entity_name": "entity_name",
545             "entity_aliases": [
546               "entity_aliases"
547             ],
548             "agency_information_url": "agency_information_url",
549             "agency_list_url": "agency_list_url",
550             "score": null
551           }
552         ]
553       },
554       {
555         "object": "watchlist_source",
556         "agency": "Office of Foreign Assets Control",
557         "agency_abbr": "OFAC",
558         "organization": "U.S. Department of Treasury",
559         "title": "Non-SDN Iranian Sanctions",
560         "abbr": "NS-ISA",
561         "results": [
562           {
563             "object": "watchlist_result",
564             "id": "id",
565             "status": "status",
566             "entity_name": "entity_name",
567             "entity_aliases": [
568               "entity_aliases"
569             ],
570             "agency_information_url": "agency_information_url",
571             "agency_list_url": "agency_list_url",
572             "score": null
573           }
574         ]
575       },
576       {
577         "object": "watchlist_source",
578         "agency": "Office of Foreign Assets Control",
579         "agency_abbr": "OFAC",
580         "organization": "U.S. Department of Treasury",
581         "title": "Non-SDN Menu-Based Sanctions",
582         "abbr": "NS-MBS",
583         "results": [
584           {
585             "object": "watchlist_result",
586             "id": "id",
587             "status": "status",
588             "entity_name": "entity_name",
589             "entity_aliases": [
590               "entity_aliases"
591             ],
592             "agency_information_url": "agency_information_url",
593             "agency_list_url": "agency_list_url",
594             "score": null
595           }
596         ]
597       },
598       {
599         "object": "watchlist_source",
600         "agency": "Office of Foreign Assets Control",
601         "agency_abbr": "OFAC",
602         "organization": "U.S. Department of Treasury",
603         "title": "Palestinian Legislative Council",
604         "abbr": "PLC",
605         "results": [
606           {
607             "object": "watchlist_result",
608             "id": "id",
609             "status": "status",
610             "entity_name": "entity_name",
611             "entity_aliases": [
612               "entity_aliases"
613             ],
614             "agency_information_url": "agency_information_url",
615             "agency_list_url": "agency_list_url",
616             "score": null
617           }
618         ]
619       },
620       {
621         "object": "watchlist_source",
622         "agency": "Office of Foreign Assets Control",
623         "agency_abbr": "OFAC",
624         "organization": "U.S. Department of Treasury",
625         "title": "Specially Designated Nationals",
626         "abbr": "SDN",
627         "results": [
628           {
629             "object": "watchlist_result",
630             "id": "id",
631             "status": "status",
632             "entity_name": "entity_name",
633             "entity_aliases": [
634               "entity_aliases"
635             ],
636             "agency_information_url": "agency_information_url",
637             "agency_list_url": "agency_list_url",
638             "score": null
639           }
640         ]
641       },
642       {
643         "object": "watchlist_source",
644         "agency": "Office of Foreign Assets Control",
645         "agency_abbr": "OFAC",
646         "organization": "U.S. Department of Treasury",
647         "title": "Sectoral Sanctions Identifications",
648         "abbr": "SSI",
649         "results": [
650           {
651             "object": "watchlist_result",
652             "id": "id",
653             "status": "status",
654             "entity_name": "entity_name",
655             "entity_aliases": [
656               "entity_aliases"
657             ],
658             "agency_information_url": "agency_information_url",
659             "agency_list_url": "agency_list_url",
660             "score": null
661           }
662         ]
663       },
664       {
665         "object": "watchlist_source",
666         "agency": "Bureau of Industry and Security",
667         "agency_abbr": "BIS",
668         "organization": "U.S. Department of Commerce",
669         "title": "Unverified List",
670         "abbr": "UVL",
671         "results": [
672           {
673             "object": "watchlist_result",
674             "id": "id",
675             "status": "status",
676             "entity_name": "entity_name",
677             "entity_aliases": [
678               "entity_aliases"
679             ],
680             "agency_information_url": "agency_information_url",
681             "agency_list_url": "agency_list_url",
682             "score": null
683           }
684         ]
685       }
686     ],
687     "people": [
688       {
689         "key": "value"
690       }
691     ]
692   },
693   "risk": {
694     "object": "risk",
695     "status": "completed",
696     "level": "low",
697     "score": 1,
698     "latest_assessment_id": "latest_assessment_id",
699     "reason": "reason"
700   },
701   "bankruptcies": [
702     {
703       "object": "bankruptcy",
704       "id": "id",
705       "business_id": "business_id",
706       "case_number": "case_number",
707       "case_updates": [
708         {}
709       ],
710       "chapter": 1.1,
711       "court": "court",
712       "filing_date": "2023-01-15",
713       "debtors": [
714         {}
715       ]
716     }
717   ],
718   "certifications": [
719     {
720       "object": "certification",
721       "name": "name",
722       "key": "key",
723       "certification_type": "federal",
724       "external_sources": [
725         {}
726       ],
727       "id": "id",
728       "business_id": "business_id",
729       "created_at": "2024-01-15T09:30:00Z",
730       "updated_at": "2024-01-15T09:30:00Z",
731       "entrance_date": "2024-01-15T09:30:00Z",
732       "exit_date": "2024-01-15T09:30:00Z",
733       "certification_id": "certification_id"
734     }
735   ],
736   "documents": [
737     {
738       "object": "document",
739       "id": "id",
740       "document_type": "document_type",
741       "filename": "filename",
742       "content_type": "application/pdf",
743       "size": 1,
744       "download_url": "download_url",
745       "created_at": "2024-01-15T09:30:00Z",
746       "filing_date": "2024-01-15T09:30:00Z",
747       "metadata": {
748         "key": "value"
749       }
750     }
751   ],
752   "liens": [
753     {
754       "object": "lien",
755       "type": "ucc",
756       "id": "id",
757       "business_id": "business_id",
758       "debtors": [
759         {}
760       ],
761       "secured_parties": [
762         {}
763       ],
764       "file_number": "file_number",
765       "state": "AL",
766       "status": "created",
767       "filing_date": "2023-01-15",
768       "status_category": "active",
769       "owner_id": "owner_id",
770       "owner_type": "owner_type",
771       "documents": [
772         {
773           "object": "document",
774           "id": "id",
775           "document_type": "document_type",
776           "filename": "filename",
777           "content_type": "application/pdf",
778           "size": 1,
779           "download_url": "download_url",
780           "created_at": "2024-01-15T09:30:00Z"
781         }
782       ],
783       "updated_date": "2023-01-15",
784       "lapse_date": "2023-01-15",
785       "collateral": "collateral",
786       "collateral_type": "Blanket",
787       "negative_pledge": true,
788       "confirmation_number": "confirmation_number",
789       "loan_principal_amount_cents": 1,
790       "source": "source",
791       "packet_number": "packet_number",
792       "lien_termination": {
793         "key": "value"
794       },
795       "liability_cents": 1,
796       "alternative_designation": "buyer_seller",
797       "filed_by_account": true
798     }
799   ],
800   "names": [
801     {
802       "object": "name",
803       "id": "764682dd-bf80-4426-910c-9850531fc86c",
804       "name": "Agent",
805       "submitted": true,
806       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
807       "sources": [
808         {
809           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
810           "type": "registration",
811           "metadata": {
812             "file_number": "FN-XXXXXXX",
813             "jurisdiction": "DOMESTIC",
814             "state": "AZ",
815             "status": "active"
816           }
817         }
818       ],
819       "type": "legal"
820     }
821   ],
822   "addresses": [
823     {
824       "object": "address",
825       "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
826       "full_address": "369 Willow St, Phoenix, AZ 85001",
827       "submitted": true,
828       "created_at": "2025-11-05T01:57:42Z",
829       "updated_at": "2025-11-05T01:57:42Z",
830       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
831       "sources": [
832         {
833           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
834           "type": "registration",
835           "metadata": {
836             "file_number": "FN-XXXXXXX",
837             "jurisdiction": "DOMESTIC",
838             "state": "AZ",
839             "status": "active"
840           }
841         }
842       ],
843       "rating": {
844         "risk_rating": "low",
845         "indicators": [
846           {
847             "type": "valid_us_address",
848             "name": "Valid US address",
849             "rating": "positive",
850             "value": "valid",
851             "description": "Valid"
852           },
853           {
854             "type": "deliverability",
855             "name": "Deliverability",
856             "rating": "positive",
857             "value": "deliverable",
858             "description": "Deliverable"
859           },
860           {
861             "type": "geographical_location",
862             "name": "Geographical location",
863             "rating": "positive",
864             "value": "us",
865             "description": "US"
866           },
867           {
868             "type": "registered_agent",
869             "name": "Valid US address",
870             "rating": "positive",
871             "value": "not_registered_agent",
872             "description": "Not a registered agent"
873           },
874           {
875             "type": "private_mailbox",
876             "name": "Private mailbox",
877             "rating": "positive",
878             "value": "not_private_mailbox",
879             "description": "Not a private mailbox"
880           },
881           {
882             "type": "location_frequency",
883             "name": "Location frequency",
884             "rating": "positive",
885             "value": "1_business",
886             "description": "1 business"
887           },
888           {
889             "type": "virtual_address",
890             "name": "Virtual address",
891             "rating": "positive",
892             "value": "not_virtual_address",
893             "description": "Not a virtual address"
894           }
895         ]
896       },
897       "address_line1": "369 Willow St",
898       "city": "Phoenix",
899       "state": "AZ",
900       "postal_code": "85001",
901       "latitude": 40.52,
902       "longitude": 30.4,
903       "deliverable": true,
904       "street_view_available": false,
905       "labels": [
906         "labels"
907       ],
908       "references": [
909         "references"
910       ],
911       "cmra": false,
912       "location_count": 1,
913       "is_registered_agent": false
914     },
915     {
916       "object": "address",
917       "id": "84852fca-bd75-4367-a089-03d67f8e7362",
918       "full_address": "354 Circle Court,Bronx, NY 10468",
919       "submitted": false,
920       "created_at": "2025-11-05T01:57:43Z",
921       "updated_at": "2025-11-05T01:57:43Z",
922       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
923       "sources": [
924         {
925           "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
926           "type": "registration",
927           "metadata": {
928             "file_number": "FN-XXXXXXX",
929             "jurisdiction": "DOMESTIC",
930             "state": "AZ",
931             "status": "active"
932           }
933         }
934       ],
935       "rating": {
936         "risk_rating": "high",
937         "indicators": [
938           {
939             "type": "valid_us_address",
940             "name": "Valid US address",
941             "rating": "negative",
942             "value": "invalid",
943             "description": "Invalid"
944           },
945           {
946             "type": "deliverability",
947             "name": "Deliverability",
948             "rating": "positive",
949             "value": "deliverable",
950             "description": "Deliverable"
951           },
952           {
953             "type": "geographical_location",
954             "name": "Geographical location",
955             "rating": "negative",
956             "value": "unknown",
957             "description": "Unknown"
958           },
959           {
960             "type": "registered_agent",
961             "name": "Valid US address",
962             "rating": "neutral",
963             "value": "unknown",
964             "description": "Unknown"
965           },
966           {
967             "type": "private_mailbox",
968             "name": "Private mailbox",
969             "rating": "neutral",
970             "value": "unknown",
971             "description": "Unknown"
972           },
973           {
974             "type": "location_frequency",
975             "name": "Location frequency",
976             "rating": "positive",
977             "value": "1_business",
978             "description": "1 business"
979           },
980           {
981             "type": "property_type",
982             "name": "Property type",
983             "rating": "neutral",
984             "value": "unknown",
985             "description": "Unknown"
986           }
987         ]
988       },
989       "address_line1": "354 Circle Ct",
990       "city": "Bronx",
991       "state": "NY",
992       "postal_code": "10468",
993       "deliverable": true,
994       "labels": [
995         "labels"
996       ],
997       "references": [
998         "references"
999       ],
1000       "cmra": false,
1001       "location_count": 1,
1002       "is_registered_agent": false
1003     }
1004   ],
1005   "people": [
1006     {
1007       "object": "person",
1008       "id": "id",
1009       "name": "name",
1010       "submitted": true,
1011       "business_id": "business_id",
1012       "titles": [
1013         {}
1014       ],
1015       "people_bankruptcies": [
1016         {
1017           "key": "value"
1018         }
1019       ],
1020       "litigations": [
1021         {
1022           "object": "litigation",
1023           "id": "id",
1024           "case_name": "case_name",
1025           "case_number": "case_number",
1026           "case_status": "OPEN",
1027           "case_type": "case_type",
1028           "filing_date": "2025-06-18",
1029           "party_type": "party_type"
1030         }
1031       ],
1032       "liens": [
1033         {
1034           "object": "lien",
1035           "type": "ucc",
1036           "id": "id",
1037           "business_id": "business_id",
1038           "debtors": [
1039             {}
1040           ],
1041           "secured_parties": [
1042             {}
1043           ],
1044           "file_number": null,
1045           "state": "AL",
1046           "status": "created",
1047           "filing_date": null,
1048           "status_category": "active",
1049           "owner_id": "owner_id",
1050           "owner_type": "owner_type",
1051           "documents": [
1052             {
1053               "object": "document",
1054               "id": "id",
1055               "document_type": "document_type",
1056               "filename": "filename",
1057               "content_type": "application/pdf",
1058               "size": 1,
1059               "download_url": "download_url",
1060               "created_at": "2024-01-15T09:30:00Z"
1061             }
1062           ]
1063         }
1064       ],
1065       "criminal_records": [
1066         {
1067           "object": "criminal_history/record",
1068           "id": "id",
1069           "category": "category",
1070           "cases": [
1071             {
1072               "object": "criminal_history/case",
1073               "charges": [
1074                 {
1075                   "object": "criminal_history/charge"
1076                 }
1077               ]
1078             }
1079           ]
1080         }
1081       ],
1082       "sources": [
1083         {
1084           "id": "id",
1085           "type": "type",
1086           "metadata": {
1087             "key": "value"
1088           }
1089         }
1090       ]
1091     }
1092   ],
1093   "phone_numbers": [
1094     {
1095       "object": "phone_number",
1096       "id": "id",
1097       "number": "number",
1098       "contact_type": "contact_type",
1099       "recommended": true
1100     }
1101   ],
1102   "email_addresses": [
1103     {
1104       "object": "email_address",
1105       "id": "id",
1106       "email": "email",
1107       "submitted": true,
1108       "sources": [
1109         {
1110           "id": "id",
1111           "type": "type",
1112           "metadata": {
1113             "key": "value"
1114           }
1115         }
1116       ],
1117       "domain": "domain",
1118       "valid": true,
1119       "deliverability": "deliverability",
1120       "disposable": true,
1121       "address_type": "disposable",
1122       "business_id": "business_id",
1123       "domain_age": "2024-01-15T09:30:00Z",
1124       "first_seen": "2024-01-15T09:30:00Z",
1125       "rating": {
1126         "risk_rating": "low"
1127       }
1128     }
1129   ],
1130   "profiles": [
1131     {
1132       "object": "profile",
1133       "id": "id",
1134       "type": "facebook",
1135       "url": "url",
1136       "external_id": "external_id",
1137       "rating": 1.1,
1138       "rating_count": 1
1139     }
1140   ],
1141   "registrations": [
1142     {
1143       "object": "registration",
1144       "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
1145       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1146       "name": "Agent",
1147       "status": "active",
1148       "jurisdiction": "DOMESTIC",
1149       "entity_type": "AGENT",
1150       "file_number": "FN-XXXXXXX",
1151       "state": "AZ",
1152       "sub_status": "GOOD_STANDING",
1153       "status_details": "Active-Good Standing",
1154       "country_code": "US",
1155       "addresses": [
1156         "369 WILLOW ST, PHOENIX, AZ 85001",
1157         "354 CIRCLE COURT,BRONX, NY 10468"
1158       ],
1159       "officers": [
1160         {
1161           "key": "value"
1162         }
1163       ],
1164       "registered_agent": {
1165         "key": "value"
1166       },
1167       "registration_date": "2020-02-24",
1168       "source": "https://ecorp.azcc.gov/BusinessSearch/BusinessInfo?entityNumber=FN-XXXXXXX",
1169       "submitted": false
1170     },
1171     {
1172       "object": "registration",
1173       "id": "69609259-dfec-4929-ba36-aca90f91b555",
1174       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1175       "name": "Agent",
1176       "status": "active",
1177       "jurisdiction": "FOREIGN",
1178       "entity_type": "AGENT",
1179       "file_number": "12345135135",
1180       "state": "CO",
1181       "country_code": "US",
1182       "addresses": [
1183         "369 WILLOW ST, PHOENIX, AZ 85001",
1184         "354 CIRCLE COURT,BRONX, NY 10468"
1185       ],
1186       "officers": [
1187         {
1188           "key": "value"
1189         }
1190       ],
1191       "registered_agent": {
1192         "key": "value"
1193       },
1194       "registration_date": "2020-02-24",
1195       "source": "https://www.sos.state.co.us/biz/BusinessEntityCriteriaExt.do",
1196       "submitted": false
1197     },
1198     {
1199       "object": "registration",
1200       "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12",
1201       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1202       "name": "Agent",
1203       "status": "active",
1204       "jurisdiction": "HOME",
1205       "entity_type": "CORPORATION",
1206       "file_number": "123456789",
1207       "state": null,
1208       "sub_status": "GOOD_STANDING",
1209       "jurisdiction_details": {
1210         "name": "Alberta",
1211         "abbr": "AB",
1212         "authority": "Corporate Registry System (CORES)"
1213       },
1214       "country_code": "CA",
1215       "addresses": [
1216         "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA"
1217       ],
1218       "officers": [
1219         {
1220           "key": "value"
1221         }
1222       ],
1223       "registration_date": "2019-04-12",
1224       "submitted": true
1225     }
1226   ],
1227   "orders": [
1228     {
1229       "object": "order",
1230       "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7",
1231       "status": "completed",
1232       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1233       "product": "business_verification_verify",
1234       "created_at": "2025-11-05T01:57:42Z",
1235       "updated_at": "2025-11-05T01:57:44Z",
1236       "subproducts": [
1237         "Articles of Incorporation"
1238       ],
1239       "completed_at": "2025-11-05T01:57:43Z",
1240       "monitoring": false,
1241       "requester": {
1242         "name": "Example Account",
1243         "type": "account"
1244       }
1245     },
1246     {
1247       "object": "order",
1248       "id": "bca42881-ed2a-4de9-84c3-25795e280bf3",
1249       "status": "completed",
1250       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1251       "product": "tax_liens",
1252       "created_at": "2025-11-05T01:57:42Z",
1253       "updated_at": "2025-11-05T01:57:44Z",
1254       "subproducts": [
1255         "Articles of Incorporation"
1256       ],
1257       "completed_at": "2025-11-05T01:57:43Z",
1258       "monitoring": false,
1259       "requester": {
1260         "name": "Example Account",
1261         "type": "account"
1262       }
1263     },
1264     {
1265       "object": "order",
1266       "id": "6e71a276-ebf4-4396-b091-3e13251a25c6",
1267       "status": "completed",
1268       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1269       "product": "litigations",
1270       "created_at": "2025-11-05T01:57:42Z",
1271       "updated_at": "2025-11-05T01:57:44Z",
1272       "subproducts": [
1273         "Articles of Incorporation"
1274       ],
1275       "completed_at": "2025-11-05T01:57:43Z",
1276       "monitoring": false,
1277       "requester": {
1278         "name": "Example Account",
1279         "type": "account"
1280       }
1281     },
1282     {
1283       "object": "order",
1284       "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140",
1285       "status": "completed",
1286       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1287       "product": "bankruptcies",
1288       "created_at": "2025-11-05T01:57:42Z",
1289       "updated_at": "2025-11-05T01:57:44Z",
1290       "subproducts": [
1291         "Articles of Incorporation"
1292       ],
1293       "completed_at": "2025-11-05T01:57:43Z",
1294       "monitoring": false,
1295       "requester": {
1296         "name": "Example Account",
1297         "type": "account"
1298       }
1299     },
1300     {
1301       "object": "order",
1302       "id": "1276547b-1cca-416f-b451-22e4a24c25fb",
1303       "status": "completed",
1304       "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
1305       "product": "ucc_liens",
1306       "created_at": "2025-11-05T01:57:42Z",
1307       "updated_at": "2025-11-05T01:57:44Z",
1308       "subproducts": [
1309         "Articles of Incorporation"
1310       ],
1311       "completed_at": "2025-11-05T01:57:43Z",
1312       "monitoring": false,
1313       "requester": {
1314         "name": "Example Account",
1315         "type": "account"
1316       }
1317     }
1318   ],
1319   "fmcsa_registrations": [
1320     {
1321       "object": "fmcsa_registration",
1322       "id": "id",
1323       "dot_number": "dot_number",
1324       "legal_name": "legal_name",
1325       "source": "source",
1326       "addresses": [
1327         "addresses"
1328       ],
1329       "dba_name": "dba_name"
1330     }
1331   ],
1332   "loans": [
1333     {
1334       "object": "loan",
1335       "id": "id",
1336       "issued_date": "2023-01-15",
1337       "amount": 1.1,
1338       "lender": "lender"
1339     }
1340   ],
1341   "litigations": [
1342     {
1343       "object": "litigation",
1344       "id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1345       "case_name": "ABC RECOVERY ASSOCIATES, LLC Et Al VS PAT RANDOM",
1346       "case_number": "GV22001014-00",
1347       "case_status": "CLOSED",
1348       "case_type": "Property",
1349       "filing_date": "2022-07-29",
1350       "party_type": "PLAINTIFF",
1351       "judgments": [
1352         {
1353           "id": "18c7e62b-5897-47c4-b583-037614ab2a40",
1354           "litigation_id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
1355           "docket_entry_date": "2001-05-01",
1356           "text": "Judgment",
1357           "created_at": "2025-11-05T01:57:43Z",
1358           "updated_at": "2025-11-05T01:57:43Z"
1359         }
1360       ],
1361       "jurisdiction": "Bedford General District Court",
1362       "jurisdiction_state": "Virginia",
1363       "parties": [
1364         {
1365           "id": "id",
1366           "name": "name",
1367           "role": "Plaintiff",
1368           "litigation_id": "litigation_id"
1369         }
1370       ]
1371     },
1372     {
1373       "object": "litigation",
1374       "id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1375       "case_name": "XYZ RECOVERY ASSOCIATES LLC ASSIGNEE VS PAT RANDOM",
1376       "case_number": "GV22007165-00",
1377       "case_status": "OPEN",
1378       "case_type": "Contract",
1379       "filing_date": "2025-11-05",
1380       "party_type": "DEFENDANT",
1381       "judgments": [
1382         {
1383           "id": "93b5bedf-dab9-4246-be74-d49343d1f2a2",
1384           "litigation_id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
1385           "docket_entry_date": "2001-05-01",
1386           "text": "Judgment: Parties For: Schmoe, Joe; Against: X.Com;",
1387           "created_at": "2025-11-05T01:57:43Z",
1388           "updated_at": "2025-11-05T01:57:43Z"
1389         }
1390       ],
1391       "jurisdiction": "Hampton General District Court",
1392       "jurisdiction_state": "Virginia",
1393       "parties": [
1394         {
1395           "id": "id",
1396           "name": "name",
1397           "role": "Plaintiff",
1398           "litigation_id": "litigation_id"
1399         }
1400       ]
1401     },
1402     {
1403       "object": "litigation",
1404       "id": "12127ea6-b177-4d4c-b270-ee2c87952a6e",
1405       "case_name": "ABC CAPITAL BANK/BEST NEO BANK Et Al VS PAT RANDOM",
1406       "case_number": "GV22007158-00",
1407       "case_status": "UNKNOWN",
1408       "case_type": "Civil",
1409       "filing_date": "2022-07-28",
1410       "party_type": "UNKNOWN",
1411       "judgments": [
1412         {
1413           "id": "id",
1414           "litigation_id": "litigation_id",
1415           "docket_entry_date": "2023-01-15",
1416           "text": "text",
1417           "created_at": "2024-01-15T09:30:00Z",
1418           "updated_at": "2024-01-15T09:30:00Z"
1419         }
1420       ],
1421       "jurisdiction": "UNKNOWN",
1422       "parties": [
1423         {
1424           "id": "id",
1425           "name": "name",
1426           "role": "Plaintiff",
1427           "litigation_id": "litigation_id"
1428         }
1429       ]
1430     }
1431   ],
1432   "policy_results": [
1433     {
1434       "object": "policy_result",
1435       "id": "id",
1436       "result": "result",
1437       "created_at": "created_at",
1438       "matched": "matched",
1439       "executed": true,
1440       "name": "name",
1441       "details": {
1442         "key": "value"
1443       },
1444       "owner_id": "owner_id",
1445       "owner_type": "owner_type",
1446       "business_id": "business_id",
1447       "type_of": "type_of",
1448       "policy_action_results": [
1449         {
1450           "object": "policy_action_result"
1451         }
1452       ]
1453     }
1454   ],
1455   "submitted": {
1456     "object": "submitted_attributes",
1457     "name": "Agent",
1458     "addresses": [
1459       {
1460         "full_address": "369 Willow St, Phoenix, AZ 85001"
1461       }
1462     ],
1463     "orders": [
1464       {}
1465     ],
1466     "people": [
1467       {
1468         "key": "value"
1469       }
1470     ],
1471     "phone_numbers": [
1472       {
1473         "key": "value"
1474       }
1475     ],
1476     "email_addresses": [
1477       {
1478         "key": "value"
1479       }
1480     ],
1481     "tin": {
1482       "tin": "123456789"
1483     },
1484     "website": {
1485       "key": "value"
1486     },
1487     "profiles": [
1488       {
1489         "key": "value"
1490       }
1491     ]
1492   },
1493   "subscription_availability": {
1494     "bankruptcy": "subscribable",
1495     "certification": "subscribable",
1496     "registration": "subscribable",
1497     "tin": "subscribable",
1498     "watchlist_result": "subscribable",
1499     "lien": "subscribable"
1500   }
1501 }

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 nullOptional

unique_external_idstring or nullOptional

tagslist of stringsOptional

requesterobject or nullOptional

assignee_idstring or nullOptionalformat: "uuid"

supported_document_typeslist of enumsOptional

reviewobject or nullOptional

tinobject or nullOptional

business_batch_idstring or nullOptionalformat: "uuid"

formationobject or nullOptional

websiteobject or nullOptional

watchlistobject or nullOptional

riskobject or nullOptional

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

bankruptcieslist of objectsOptional

certificationslist of objectsOptional

documentslist of objectsOptional

lienslist of objectsOptional

nameslist of objectsOptional

addresseslist of objectsOptional

peoplelist of objectsOptional

phone_numberslist of objectsOptional

email_addresseslist of objectsOptional

profileslist of objectsOptional

registrationslist of objectsOptional

orderslist of objectsOptional

industry_classificationobject or nullOptional

monitorobject or nullOptional

tax_exempt_organizationobject or nullOptional

fmcsa_registrationslist of objectsOptional

loanslist of objects or nullOptional

litigationslist of objectsOptional

policy_resultslist of objectsOptional

politically_exposed_person_screeningobject or nullOptional

adverse_media_screeningobject or nullOptional

signalobject or nullOptional

submittedobjectOptional

subscriptionobject or nullOptional

subscription_availabilityobject or nullOptional

Errors

404

Get Business Request Not Found Error