# Avalara License Guidance Order API

Used for placing Avalara License Guidance orders and passing in known information into the ALG questionnaire.

Source: https://developer.avalara.com/products/registration-and-licensing/api/

**Version:** 1.0.0
**Base URL:** https://www.businesslicenses.com

---

## Endpoints

### Orders

#### Create an Avalara License Guidance order

`POST /licensesuite/endpoint.php`

Creates a new order for business license compliance processing. This endpoint accepts business information, location data, and business activities to generate a license report. The API validates the API key and processes the submitted data, including location validation and business activity classification.


### Order Status

#### Retrieve the order status

`GET /blms/webservice/license-guidance/order/status.json`

Retrieves status information after the order is created

**Parameters:**

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `key` | string | query | Yes | API key provided by Avalara for authentication |
| `order_number` | string | query | Yes | Order number |

---

## Models

### Location

Business location information

| Property | Type | Description |
|---|---|---|
| `address1` | string | Street address line 1 |
| `city` | string | City name |
| `state` | string | Two character state abbreviation |
| `postal_code` | string | ZIP or postal code |
| `county` | string | County name |
| `country` | string | Two-character country code |

### BusinessActivity

Business activity information

| Property | Type | Description |
|---|---|---|
| `business_activity_id` | string | Business activity ID in the format 'master-sub-industry-activity' |

### OrderAnswer

Answers to questions in the order flow

| Property | Type | Description |
|---|---|---|
| `Incorporated Type` | string | Business incorporation type |
| `Incorporated State` | string | State where the business was incorporated, using a two-character code |
| `DBA` | string | Indicates whether the business uses a DBA name |
| `Employees` | string | Business has employees |
| `Residential or Commercial` | string | Indicates whether the business operates in a residential or commercial area |

### OrderStatusResponse

Successful order status response

| Property | Type | Description |
|---|---|---|
| `ReturnCode` | string | Return code for the request |
| `ErrorCode` | number | Error code for the request |
| `ErrorMessage` | string | Error message for the request |
| `Order` | object | Order status details |

### OrderStatusInvalidResponse

Invalid order status request response

| Property | Type | Description |
|---|---|---|
| `ReturnCode` | string | Return code for the request |
| `ErrorCode` | number | Error code for the request |
| `ErrorMessage` | string | Error message for the request |