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>"

{
  "object": "business",
  "id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
  "name": "Agent",
  "status": "in_review",
  "created_at": "2025-11-05T01:57:42Z",
  "updated_at": "2025-11-05T01:57:44Z",
  "tags": [
    "tags"
  ],
  "requester": {
    "id": "d903a801-88e0-441f-bc5f-49593163e755",
    "type": "account",
    "name": "Example Account",
    "requested_at": "2025-11-05T01:57:42Z"
  },
  "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c",
  "supported_document_types": [
    "Certificate of Good Standing"
  ],
  "review": {
    "object": "review",
    "id": "17be8ac9-da36-4e10-bd99-9a4dcb520358",
    "created_at": "2025-11-05T01:57:42Z",
    "updated_at": "2025-11-05T01:57:42Z",
    "tasks": [
      {
        "category": "tin",
        "key": "tin",
        "label": "TIN Match",
        "message": "The IRS does not have a record for the submitted TIN and Business Name combination",
        "name": "tin",
        "status": "failure",
        "sub_label": "Not Found",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "litigations",
        "key": "litigations",
        "label": "Litigations",
        "message": "The business has 3 related litigations",
        "name": "litigations",
        "status": "failure",
        "sub_label": "Found",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "liens",
        "key": "liens",
        "label": "Liens",
        "message": "No Liens found",
        "name": "liens",
        "status": "success",
        "sub_label": "No Liens",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "name",
        "key": "name",
        "label": "Business Name",
        "message": "Match identified to the submitted Business Name",
        "name": "name",
        "status": "success",
        "sub_label": "Verified",
        "sources": [
          {
            "id": "764682dd-bf80-4426-910c-9850531fc86c",
            "type": "name",
            "metadata": {
              "name": "Agent",
              "submitted": true
            }
          }
        ]
      },
      {
        "category": "address",
        "key": "address_verification",
        "label": "Office Address",
        "message": "Match identified to the submitted Office Address",
        "name": "address",
        "status": "success",
        "sub_label": "Verified",
        "sources": [
          {
            "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
            "type": "address",
            "metadata": {
              "address_line1": "369 Willow St",
              "city": "Phoenix",
              "full_address": "369 Willow St, Phoenix, AZ 85001",
              "postal_code": "85001",
              "state": "AZ",
              "submitted": true
            }
          }
        ]
      },
      {
        "category": "address",
        "key": "address_deliverability",
        "label": "Office Address",
        "message": "The USPS is able to deliver mail to the submitted Office Address",
        "name": "address",
        "status": "success",
        "sub_label": "Deliverable",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "address",
        "key": "address_property_type",
        "label": "Office Address",
        "message": "Submitted Office Address is a Commercial property",
        "name": "address",
        "status": "success",
        "sub_label": "Commercial",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "address",
        "key": "location_frequency",
        "label": "Office Address",
        "message": "1 business uses this location",
        "name": "address",
        "status": "success",
        "sub_label": "Low frequency",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "address",
        "key": "address_risk",
        "label": "Address Risk",
        "message": "Address risk is low",
        "name": "address",
        "status": "success",
        "sub_label": "Low",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "sos",
        "key": "sos_match",
        "label": "SOS Filings",
        "message": "The business is Active in the state of the submitted Office Address",
        "name": "sos",
        "status": "success",
        "sub_label": "Submitted Active",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "sos",
        "key": "sos_active",
        "label": "SOS Filings",
        "message": "2 of 2 filings are Active",
        "name": "sos",
        "status": "success",
        "sub_label": "Active",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "sos",
        "key": "sos_domestic_sub_status",
        "label": "SOS Domestic Sub‑status",
        "message": "The domestic registration is in Good Standing.",
        "name": "sos",
        "status": "success",
        "sub_label": "Good Standing",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "sos",
        "key": "sos_domestic",
        "label": "SOS Filings",
        "message": "Active domestic filing found",
        "name": "sos",
        "status": "success",
        "sub_label": "Domestic Active",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "watchlist",
        "key": "watchlist",
        "label": "Watchlist",
        "message": "No Watchlist hits were identified",
        "name": "watchlist",
        "status": "success",
        "sub_label": "No Hits",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      },
      {
        "category": "bankruptcies",
        "key": "bankruptcies",
        "label": "Bankruptcies",
        "message": "The business has no bankruptcy filings",
        "name": "bankruptcies",
        "status": "success",
        "sub_label": "None Found",
        "sources": [
          {
            "id": "id",
            "type": "type",
            "metadata": {
              "key": "value"
            }
          }
        ]
      }
    ],
    "analyst_read_markdown": "analyst_read_markdown",
    "analyst_read_generated_at": "2024-01-15T09:30:00Z",
    "assignee": {
      "object": "user",
      "id": "454913d6-2f79-4fc0-9234-4443f253af3c",
      "name": "John Doe",
      "email": "example@example.com",
      "roles": [
        "admin",
        "member"
      ],
      "created_at": "2024-09-17T18:08:00Z",
      "image_url": "https://www.gravatar.com/avatar/fa4fe13fa938ade11d07571178575ccf?s=64&d=https%3A%2F%2Fapp-sandbox.middesk.com%2Fimages%2Fdefault-avatar.png",
      "directory_managed": false,
      "last_login_at": "2024-09-20T16:24:39Z",
      "settings": {
        "receives_agent_emails": false
      }
    }
  },
  "tin": {
    "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
    "tin": "12-3456789",
    "name": "Agent",
    "mismatch": false,
    "unknown": true,
    "verified": false,
    "updated_at": "2025-11-05T01:57:43Z",
    "issued": true
  },
  "formation": {
    "created_at": "2025-11-05T01:57:43Z",
    "updated_at": "2025-11-05T01:57:43Z",
    "entity_type": "AGENT",
    "formation_date": "2020-02-24",
    "formation_state": "AZ",
    "sources": [
      {
        "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
        "type": "registration",
        "metadata": {
          "file_number": "FN-XXXXXXX",
          "jurisdiction": "DOMESTIC",
          "state": "AZ",
          "status": "active"
        }
      }
    ]
  },
  "watchlist": {
    "object": "watchlist",
    "id": "145cf041-cb0a-447a-ab2a-0d721688b126",
    "hit_count": 0,
    "agencies": [
      {
        "abbr": "OFAC",
        "name": "Office of Foreign Assets Control",
        "org": "U.S. Department of Treasury"
      },
      {
        "abbr": "BIS",
        "name": "Bureau of Industry and Security",
        "org": "U.S. Department of Commerce"
      },
      {
        "abbr": "DDTC",
        "name": "Directorate of Defense Trade Controls",
        "org": "U.S. Department of State"
      },
      {
        "abbr": "ISN",
        "name": "Bureau of International Security and Non-Proliferation",
        "org": "U.S. Department of State"
      }
    ],
    "lists": [
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Capta List",
        "abbr": "CAP",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Bureau of Industry and Security",
        "agency_abbr": "BIS",
        "organization": "U.S. Department of Commerce",
        "title": "Denied Persons List",
        "abbr": "DPL",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Directorate of Defense Trade Controls",
        "agency_abbr": "DDTC",
        "organization": "U.S. Department of State",
        "title": "AECA/ITAR Debarred",
        "abbr": "DTC",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Bureau of Industry and Security",
        "agency_abbr": "BIS",
        "organization": "U.S. Department of Commerce",
        "title": "Entity List",
        "abbr": "EL",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Foreign Sanctions Evaders",
        "abbr": "FSE",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Bureau of International Security and Non-Proliferation",
        "agency_abbr": "ISN",
        "organization": "U.S. Department of State",
        "title": "Nonproliferation Sanctions",
        "abbr": "ISN",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Bureau of Industry and Security",
        "agency_abbr": "BIS",
        "organization": "U.S. Department of Commerce",
        "title": "Military End User",
        "abbr": "MEU",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Non-SDN Chinese Military-Industrial Complex Companies List",
        "abbr": "NS-CMIC",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Non-SDN Iranian Sanctions",
        "abbr": "NS-ISA",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Non-SDN Menu-Based Sanctions",
        "abbr": "NS-MBS",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Palestinian Legislative Council",
        "abbr": "PLC",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Specially Designated Nationals",
        "abbr": "SDN",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Office of Foreign Assets Control",
        "agency_abbr": "OFAC",
        "organization": "U.S. Department of Treasury",
        "title": "Sectoral Sanctions Identifications",
        "abbr": "SSI",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      },
      {
        "object": "watchlist_source",
        "agency": "Bureau of Industry and Security",
        "agency_abbr": "BIS",
        "organization": "U.S. Department of Commerce",
        "title": "Unverified List",
        "abbr": "UVL",
        "results": [
          {
            "object": "watchlist_result",
            "id": "id",
            "status": "status",
            "entity_name": "entity_name",
            "entity_aliases": [
              "entity_aliases"
            ],
            "agency_information_url": "agency_information_url",
            "agency_list_url": "agency_list_url",
            "score": null
          }
        ]
      }
    ],
    "people": [
      {
        "key": "value"
      }
    ]
  },
  "risk": {
    "object": "risk",
    "status": "completed",
    "level": "low",
    "score": 1,
    "latest_assessment_id": "latest_assessment_id",
    "reason": "reason"
  },
  "bankruptcies": [
    {
      "object": "bankruptcy",
      "id": "id",
      "business_id": "business_id",
      "case_number": "case_number",
      "case_updates": [
        {}
      ],
      "chapter": 1.1,
      "court": "court",
      "filing_date": "2023-01-15",
      "debtors": [
        {}
      ]
    }
  ],
  "certifications": [
    {
      "object": "certification",
      "name": "name",
      "key": "key",
      "certification_type": "federal",
      "external_sources": [
        {}
      ],
      "id": "id",
      "business_id": "business_id",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "entrance_date": "2024-01-15T09:30:00Z",
      "exit_date": "2024-01-15T09:30:00Z",
      "certification_id": "certification_id"
    }
  ],
  "documents": [
    {
      "object": "document",
      "id": "id",
      "document_type": "document_type",
      "filename": "filename",
      "content_type": "application/pdf",
      "size": 1,
      "download_url": "download_url",
      "created_at": "2024-01-15T09:30:00Z",
      "filing_date": "2024-01-15T09:30:00Z",
      "metadata": {
        "key": "value"
      }
    }
  ],
  "liens": [
    {
      "object": "lien",
      "type": "ucc",
      "id": "id",
      "business_id": "business_id",
      "debtors": [
        {}
      ],
      "secured_parties": [
        {}
      ],
      "file_number": "file_number",
      "state": "AL",
      "status": "created",
      "filing_date": "2023-01-15",
      "status_category": "active",
      "owner_id": "owner_id",
      "owner_type": "owner_type",
      "documents": [
        {
          "object": "document",
          "id": "id",
          "document_type": "document_type",
          "filename": "filename",
          "content_type": "application/pdf",
          "size": 1,
          "download_url": "download_url",
          "created_at": "2024-01-15T09:30:00Z"
        }
      ],
      "updated_date": "2023-01-15",
      "lapse_date": "2023-01-15",
      "collateral": "collateral",
      "collateral_type": "Blanket",
      "negative_pledge": true,
      "confirmation_number": "confirmation_number",
      "loan_principal_amount_cents": 1,
      "source": "source",
      "packet_number": "packet_number",
      "lien_termination": {
        "key": "value"
      },
      "liability_cents": 1,
      "alternative_designation": "buyer_seller",
      "filed_by_account": true
    }
  ],
  "names": [
    {
      "object": "name",
      "id": "764682dd-bf80-4426-910c-9850531fc86c",
      "name": "Agent",
      "submitted": true,
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "sources": [
        {
          "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
          "type": "registration",
          "metadata": {
            "file_number": "FN-XXXXXXX",
            "jurisdiction": "DOMESTIC",
            "state": "AZ",
            "status": "active"
          }
        }
      ],
      "type": "legal"
    }
  ],
  "addresses": [
    {
      "object": "address",
      "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd",
      "full_address": "369 Willow St, Phoenix, AZ 85001",
      "submitted": true,
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:42Z",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "sources": [
        {
          "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
          "type": "registration",
          "metadata": {
            "file_number": "FN-XXXXXXX",
            "jurisdiction": "DOMESTIC",
            "state": "AZ",
            "status": "active"
          }
        }
      ],
      "rating": {
        "risk_rating": "low",
        "indicators": [
          {
            "type": "valid_us_address",
            "name": "Valid US address",
            "rating": "positive",
            "value": "valid",
            "description": "Valid"
          },
          {
            "type": "deliverability",
            "name": "Deliverability",
            "rating": "positive",
            "value": "deliverable",
            "description": "Deliverable"
          },
          {
            "type": "geographical_location",
            "name": "Geographical location",
            "rating": "positive",
            "value": "us",
            "description": "US"
          },
          {
            "type": "registered_agent",
            "name": "Valid US address",
            "rating": "positive",
            "value": "not_registered_agent",
            "description": "Not a registered agent"
          },
          {
            "type": "private_mailbox",
            "name": "Private mailbox",
            "rating": "positive",
            "value": "not_private_mailbox",
            "description": "Not a private mailbox"
          },
          {
            "type": "location_frequency",
            "name": "Location frequency",
            "rating": "positive",
            "value": "1_business",
            "description": "1 business"
          },
          {
            "type": "virtual_address",
            "name": "Virtual address",
            "rating": "positive",
            "value": "not_virtual_address",
            "description": "Not a virtual address"
          }
        ]
      },
      "address_line1": "369 Willow St",
      "city": "Phoenix",
      "state": "AZ",
      "postal_code": "85001",
      "latitude": 40.52,
      "longitude": 30.4,
      "deliverable": true,
      "street_view_available": false,
      "labels": [
        "labels"
      ],
      "references": [
        "references"
      ],
      "cmra": false,
      "location_count": 1,
      "is_registered_agent": false
    },
    {
      "object": "address",
      "id": "84852fca-bd75-4367-a089-03d67f8e7362",
      "full_address": "354 Circle Court,Bronx, NY 10468",
      "submitted": false,
      "created_at": "2025-11-05T01:57:43Z",
      "updated_at": "2025-11-05T01:57:43Z",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "sources": [
        {
          "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
          "type": "registration",
          "metadata": {
            "file_number": "FN-XXXXXXX",
            "jurisdiction": "DOMESTIC",
            "state": "AZ",
            "status": "active"
          }
        }
      ],
      "rating": {
        "risk_rating": "high",
        "indicators": [
          {
            "type": "valid_us_address",
            "name": "Valid US address",
            "rating": "negative",
            "value": "invalid",
            "description": "Invalid"
          },
          {
            "type": "deliverability",
            "name": "Deliverability",
            "rating": "positive",
            "value": "deliverable",
            "description": "Deliverable"
          },
          {
            "type": "geographical_location",
            "name": "Geographical location",
            "rating": "negative",
            "value": "unknown",
            "description": "Unknown"
          },
          {
            "type": "registered_agent",
            "name": "Valid US address",
            "rating": "neutral",
            "value": "unknown",
            "description": "Unknown"
          },
          {
            "type": "private_mailbox",
            "name": "Private mailbox",
            "rating": "neutral",
            "value": "unknown",
            "description": "Unknown"
          },
          {
            "type": "location_frequency",
            "name": "Location frequency",
            "rating": "positive",
            "value": "1_business",
            "description": "1 business"
          },
          {
            "type": "property_type",
            "name": "Property type",
            "rating": "neutral",
            "value": "unknown",
            "description": "Unknown"
          }
        ]
      },
      "address_line1": "354 Circle Ct",
      "city": "Bronx",
      "state": "NY",
      "postal_code": "10468",
      "deliverable": true,
      "labels": [
        "labels"
      ],
      "references": [
        "references"
      ],
      "cmra": false,
      "location_count": 1,
      "is_registered_agent": false
    }
  ],
  "people": [
    {
      "object": "person",
      "id": "id",
      "name": "name",
      "submitted": true,
      "business_id": "business_id",
      "titles": [
        {}
      ],
      "people_bankruptcies": [
        {
          "key": "value"
        }
      ],
      "litigations": [
        {
          "object": "litigation",
          "id": "id",
          "case_name": "case_name",
          "case_number": "case_number",
          "case_status": "OPEN",
          "case_type": "case_type",
          "filing_date": "2025-06-18",
          "party_type": "party_type"
        }
      ],
      "liens": [
        {
          "object": "lien",
          "type": "ucc",
          "id": "id",
          "business_id": "business_id",
          "debtors": [
            {}
          ],
          "secured_parties": [
            {}
          ],
          "file_number": null,
          "state": "AL",
          "status": "created",
          "filing_date": null,
          "status_category": "active",
          "owner_id": "owner_id",
          "owner_type": "owner_type",
          "documents": [
            {
              "object": "document",
              "id": "id",
              "document_type": "document_type",
              "filename": "filename",
              "content_type": "application/pdf",
              "size": 1,
              "download_url": "download_url",
              "created_at": "2024-01-15T09:30:00Z"
            }
          ]
        }
      ],
      "criminal_records": [
        {
          "object": "criminal_history/record",
          "id": "id",
          "category": "category",
          "cases": [
            {
              "object": "criminal_history/case",
              "charges": [
                {
                  "object": "criminal_history/charge"
                }
              ]
            }
          ]
        }
      ],
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ]
    }
  ],
  "phone_numbers": [
    {
      "object": "phone_number",
      "id": "id",
      "number": "number",
      "contact_type": "contact_type",
      "recommended": true
    }
  ],
  "email_addresses": [
    {
      "object": "email_address",
      "id": "id",
      "email": "email",
      "submitted": true,
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ],
      "domain": "domain",
      "valid": true,
      "deliverability": "deliverability",
      "disposable": true,
      "address_type": "disposable",
      "business_id": "business_id",
      "domain_age": "2024-01-15T09:30:00Z",
      "first_seen": "2024-01-15T09:30:00Z",
      "rating": {
        "risk_rating": "low"
      }
    }
  ],
  "profiles": [
    {
      "object": "profile",
      "id": "id",
      "type": "facebook",
      "url": "url",
      "external_id": "external_id",
      "rating": 1.1,
      "rating_count": 1
    }
  ],
  "registrations": [
    {
      "object": "registration",
      "id": "bdf7f80f-d6da-4f28-ba98-62b7d2b88b55",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "name": "Agent",
      "status": "active",
      "jurisdiction": "DOMESTIC",
      "entity_type": "AGENT",
      "file_number": "FN-XXXXXXX",
      "state": "AZ",
      "sub_status": "GOOD_STANDING",
      "status_details": "Active-Good Standing",
      "country_code": "US",
      "addresses": [
        "369 WILLOW ST, PHOENIX, AZ 85001",
        "354 CIRCLE COURT,BRONX, NY 10468"
      ],
      "officers": [
        {
          "key": "value"
        }
      ],
      "registered_agent": {
        "key": "value"
      },
      "registration_date": "2020-02-24",
      "source": "https://ecorp.azcc.gov/BusinessSearch/BusinessInfo?entityNumber=FN-XXXXXXX",
      "submitted": false
    },
    {
      "object": "registration",
      "id": "69609259-dfec-4929-ba36-aca90f91b555",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "name": "Agent",
      "status": "active",
      "jurisdiction": "FOREIGN",
      "entity_type": "AGENT",
      "file_number": "12345135135",
      "state": "CO",
      "country_code": "US",
      "addresses": [
        "369 WILLOW ST, PHOENIX, AZ 85001",
        "354 CIRCLE COURT,BRONX, NY 10468"
      ],
      "officers": [
        {
          "key": "value"
        }
      ],
      "registered_agent": {
        "key": "value"
      },
      "registration_date": "2020-02-24",
      "source": "https://www.sos.state.co.us/biz/BusinessEntityCriteriaExt.do",
      "submitted": false
    },
    {
      "object": "registration",
      "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "name": "Agent",
      "status": "active",
      "jurisdiction": "HOME",
      "entity_type": "CORPORATION",
      "file_number": "123456789",
      "state": null,
      "sub_status": "GOOD_STANDING",
      "jurisdiction_details": {
        "name": "Alberta",
        "abbr": "AB",
        "authority": "Corporate Registry System (CORES)"
      },
      "country_code": "CA",
      "addresses": [
        "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA"
      ],
      "officers": [
        {
          "key": "value"
        }
      ],
      "registration_date": "2019-04-12",
      "submitted": true
    }
  ],
  "orders": [
    {
      "object": "order",
      "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7",
      "status": "completed",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "product": "business_verification_verify",
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:44Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2025-11-05T01:57:43Z",
      "monitoring": false,
      "requester": {
        "name": "Example Account",
        "type": "account"
      }
    },
    {
      "object": "order",
      "id": "bca42881-ed2a-4de9-84c3-25795e280bf3",
      "status": "completed",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "product": "tax_liens",
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:44Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2025-11-05T01:57:43Z",
      "monitoring": false,
      "requester": {
        "name": "Example Account",
        "type": "account"
      }
    },
    {
      "object": "order",
      "id": "6e71a276-ebf4-4396-b091-3e13251a25c6",
      "status": "completed",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "product": "litigations",
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:44Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2025-11-05T01:57:43Z",
      "monitoring": false,
      "requester": {
        "name": "Example Account",
        "type": "account"
      }
    },
    {
      "object": "order",
      "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140",
      "status": "completed",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "product": "bankruptcies",
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:44Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2025-11-05T01:57:43Z",
      "monitoring": false,
      "requester": {
        "name": "Example Account",
        "type": "account"
      }
    },
    {
      "object": "order",
      "id": "1276547b-1cca-416f-b451-22e4a24c25fb",
      "status": "completed",
      "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670",
      "product": "ucc_liens",
      "created_at": "2025-11-05T01:57:42Z",
      "updated_at": "2025-11-05T01:57:44Z",
      "subproducts": [
        "Articles of Incorporation"
      ],
      "completed_at": "2025-11-05T01:57:43Z",
      "monitoring": false,
      "requester": {
        "name": "Example Account",
        "type": "account"
      }
    }
  ],
  "fmcsa_registrations": [
    {
      "object": "fmcsa_registration",
      "id": "id",
      "dot_number": "dot_number",
      "legal_name": "legal_name",
      "source": "source",
      "addresses": [
        "addresses"
      ],
      "dba_name": "dba_name"
    }
  ],
  "loans": [
    {
      "object": "loan",
      "id": "id",
      "issued_date": "2023-01-15",
      "amount": 1.1,
      "lender": "lender"
    }
  ],
  "litigations": [
    {
      "object": "litigation",
      "id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
      "case_name": "ABC RECOVERY ASSOCIATES, LLC Et Al VS PAT RANDOM",
      "case_number": "GV22001014-00",
      "case_status": "CLOSED",
      "case_type": "Property",
      "filing_date": "2022-07-29",
      "party_type": "PLAINTIFF",
      "judgments": [
        {
          "id": "18c7e62b-5897-47c4-b583-037614ab2a40",
          "litigation_id": "0d4fa2f1-5386-47f7-9520-deb7dd94e0de",
          "docket_entry_date": "2001-05-01",
          "text": "Judgment",
          "created_at": "2025-11-05T01:57:43Z",
          "updated_at": "2025-11-05T01:57:43Z"
        }
      ],
      "jurisdiction": "Bedford General District Court",
      "jurisdiction_state": "Virginia",
      "parties": [
        {
          "id": "id",
          "name": "name",
          "role": "Plaintiff",
          "litigation_id": "litigation_id"
        }
      ]
    },
    {
      "object": "litigation",
      "id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
      "case_name": "XYZ RECOVERY ASSOCIATES LLC ASSIGNEE VS PAT RANDOM",
      "case_number": "GV22007165-00",
      "case_status": "OPEN",
      "case_type": "Contract",
      "filing_date": "2025-11-05",
      "party_type": "DEFENDANT",
      "judgments": [
        {
          "id": "93b5bedf-dab9-4246-be74-d49343d1f2a2",
          "litigation_id": "2bb39400-18e9-472d-a78f-77efc696bc2d",
          "docket_entry_date": "2001-05-01",
          "text": "Judgment: Parties For: Schmoe, Joe; Against: X.Com;",
          "created_at": "2025-11-05T01:57:43Z",
          "updated_at": "2025-11-05T01:57:43Z"
        }
      ],
      "jurisdiction": "Hampton General District Court",
      "jurisdiction_state": "Virginia",
      "parties": [
        {
          "id": "id",
          "name": "name",
          "role": "Plaintiff",
          "litigation_id": "litigation_id"
        }
      ]
    },
    {
      "object": "litigation",
      "id": "12127ea6-b177-4d4c-b270-ee2c87952a6e",
      "case_name": "ABC CAPITAL BANK/BEST NEO BANK Et Al VS PAT RANDOM",
      "case_number": "GV22007158-00",
      "case_status": "UNKNOWN",
      "case_type": "Civil",
      "filing_date": "2022-07-28",
      "party_type": "UNKNOWN",
      "judgments": [
        {
          "id": "id",
          "litigation_id": "litigation_id",
          "docket_entry_date": "2023-01-15",
          "text": "text",
          "created_at": "2024-01-15T09:30:00Z",
          "updated_at": "2024-01-15T09:30:00Z"
        }
      ],
      "jurisdiction": "UNKNOWN",
      "parties": [
        {
          "id": "id",
          "name": "name",
          "role": "Plaintiff",
          "litigation_id": "litigation_id"
        }
      ]
    }
  ],
  "policy_results": [
    {
      "object": "policy_result",
      "id": "id",
      "result": "result",
      "created_at": "created_at",
      "matched": "matched",
      "executed": true,
      "name": "name",
      "details": {
        "key": "value"
      },
      "owner_id": "owner_id",
      "owner_type": "owner_type",
      "business_id": "business_id",
      "type_of": "type_of",
      "policy_action_results": [
        {
          "object": "policy_action_result"
        }
      ]
    }
  ],
  "submitted": {
    "object": "submitted_attributes",
    "name": "Agent",
    "name_derived": true,
    "addresses": [
      {
        "full_address": "369 Willow St, Phoenix, AZ 85001"
      }
    ],
    "orders": [
      {}
    ],
    "people": [
      {
        "key": "value"
      }
    ],
    "phone_numbers": [
      {
        "key": "value"
      }
    ],
    "email_addresses": [
      {
        "key": "value"
      }
    ],
    "tin": {
      "tin": "123456789"
    },
    "website": {
      "key": "value"
    },
    "profiles": [
      {
        "key": "value"
      }
    ]
  },
  "subscription_availability": {
    "bankruptcy": "subscribable",
    "certification": "subscribable",
    "registration": "subscribable",
    "tin": "subscribable",
    "watchlist_result": "subscribable",
    "lien": "subscribable"
  }
}

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

Allowed values:

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