---
title: "Create business verification (Deprecated)"
method: POST
path: "/v2/book/{book_uuid}/business"
tags: ["Business Verification (Deprecated)"]
deprecated: true
---

# Create business verification (Deprecated)

`POST /v2/book/{book_uuid}/business`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v2/book/{book_uuid}/business`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

> **Deprecated.**

Create a new business for verification and due diligence. 

---

Once created, we will automatically begin verifying the legitimacy of the business.


We have partnered with Middesk to bring you this data. To use this endpoint, please follow the following steps:
1. Sign up for an account with [Middesk](https://middesk.com/).
2. Get your Middesk production API key (we don't support sandbox accounts at the moment).
3. Call our [Vendor Auth](ref:vendor-auth) with `middesk` as the vendor name and put the API key in the request body.
4. Set up an Ocrolus webhook by calling [Configure Webhook](ref:configure-webhook) to get back the Middesk results as soon as they are done processing.
5. Call this endpoint with the uuid for a Book containing one of your business loan applicants to get the verification process started.
- Make sure the Book is verified before making the call.
6. Get the results back in a timely way with the webhook you set up earlier!
7. Or you can also call the [Retrieve business verification](ref:retrieve-business) endpoint with the book_uuid and business_uuid in case you prefer to get back the results this way.

## Path parameters

- `book_uuid` string, uuid, required

## Query parameters

- `name` string
- `addresses` object[]
- `website` string

## Response `200`

Success

- SuccessBusinessVerification
  - `book_uuid` string: A universal unique identification code for a <<glossary:Book>>.
  - `business_uuid` string: A universal unique identification code for a business.
  - `middesk_response` object: An object potentially containg information from Middesk.

## Other responses

- `400`: Client Errors

---

[API](https://skmtc.dev/ocrolus/apis/detect.md) - [All operations](https://skmtc.dev/ocrolus/apis/detect/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/detect/revisions/6fd873ec86b0?raw)