---
title: "Async Review Company"
method: POST
path: "/api/v1/company/async/search"
tags: ["Async Web Presence Review"]
---

# Async Review Company

`POST /api/v1/company/async/search`

This API endpoint allows you to enqueue a web presence review based on either a website (as a URL, domain,
or email) or both a business name and address. Other optional information about the company and
 applicant (phone, email, applicant name) can help identify the business and locate additional detail.
You may either poll for status updates using the url provided in the response's `Location` header, or,
if you have a webhook configured, wait for us to notify you when the web presence review is completed.
(You may then request the details from the Web Presence Review History endpoint.)
This API requires a valid API key (X-API-KEY) to be  provided in the headers and is rate limited to 5 requests
per second.

## Request body

- AsyncCompanyQuery
  - `domain` string, nullable — The business's domain. **Required unless you provide `submitted_business_name` together with an address.** Accepts a bare domain, full URL, or email — we reduce it to the registered domain per Mozilla's Public Suffix List. (RFC 1034/1035 for ASCII, IDNA2008 for internationalized.)
  - `submitted_business_name` string, nullable — The business's name. **Required (along with an address) if you do not provide `domain`.**
  - `submitted_description` string, nullable — A description of the business's industry/operations
  - `address_line_1` string, nullable — Line 1 of the business address. **At least one address field is required when identifying the business by name instead of domain.**
  - `address_line_2` string, nullable — Line 2 of the business address.
  - `city` string, nullable — City of the business address.
  - `state_province` string, nullable — State/Province of the business address.
  - `postal_code` string, nullable — Postal code of the business address.
  - `country` string, nullable — Country of the business address
  - `submitted_email` string, nullable — The email of the business or applicant. (Emails should conform to the IETF RFC 5322 spec)
  - `submitted_phone` string, nullable — The phone number of the business or applicant. (Phone numbers should conform to the ITU-T E.164 standard)
  - `submitted_full_name` string, nullable — The full name of the applicant.
  - `match_profile_id` string, uuid, nullable — ID of the TrueBiz match profile to use when processing the request.
  - `external_tracking_ref` string, nullable — ID used in your system to track this request.

## Response `200`

OK

- AsyncMessage
  - `message` string — The message response from the server.
  - `tracking_id` string, uuid — ID used to track this request in TrueBiz's application.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truebiz/truebiz-web-presence-review-api/revisions/22a9a6d3740a/schema)