---
title: "Send your whole vendor list for a Florida license, workers' compensation and stop-work order check. Results start in seconds. We run the whole list once at no cost and email the full table when the check finishes. After the first results the list can be kept on Record watch, a paid option offered privately with the results: when the state posts new records we read it again (licenses every day) and email only about vendors that changed, with the read date and the state link."
method: POST
path: "/v1/vendor-checks"
tags: ["Vendor checks"]
---

# Send your whole vendor list for a Florida license, workers' compensation and stop-work order check. Results start in seconds. We run the whole list once at no cost and email the full table when the check finishes. After the first results the list can be kept on Record watch, a paid option offered privately with the results: when the state posts new records we read it again (licenses every day) and email only about vendors that changed, with the read date and the state link.

`POST /v1/vendor-checks`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/vendor-checks`
- Auth: none required

## Request body

- object
  - `email` string, email, required
  - `company` string
  - `vendors` union[]: Each vendor is {name, license_number?, city?} or just its name as a string; use instead of text.
    - union
      - string
      - object
        - `name` string, required
        - `license_number` string
        - `city` string
  - `text` string: One vendor name per line; use instead of vendors.
  - `ref_code` string: Optional. A campaign code, or a referral code (ref_ followed by 32 hex characters). A person's referral code attributes this email to that person only when a signed-in session with this email sends the request, or, for a vendor list, when its Record watch is paid by this email (one referrer per email, the first one; never the same email or company domain). Nothing is paid until this email's first real payment.
  - `contact_time` string: Leave empty.
  - `source` 'web_home' | 'web_fl' | 'api' | 'mcp' | 'webmcp'

## Response `200`

Received. Results start in seconds. We email the full table when the check finishes.

- object
  - `success` unknown, required
  - `data` object, required
    - `results_url` string, required
    - `estimated_seconds` integer, required
    - `request_id` string, uuid, required
    - `vendor_count` integer, required
    - `status` 'received', required
    - `next` 'Results start in seconds. We email the full table when the check finishes.', required

## Other responses

- `400`: Invalid email or list. Send exactly one list with one or more named vendors.
- `413`: Upload exceeds 4 MB or request exceeds 4.4 MB. Send a smaller file.
- `429`: Too many requests. Try again in one hour.
- `503`: Could not save the request. Try again in a minute.

---

[API](https://skmtc.dev/licium/apis/licium-public-api.md) · [All operations](https://skmtc.dev/licium/apis/licium-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/licium/apis/licium-public-api/revisions/d91a72f755f4?raw)