Licium Vendor checks API
Send a contractor list and read Florida license, workers' comp and stop-work order records. No key.
Send a contractor list and read Florida license, workers' comp and stop-work order records. No key.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/licium-ai:licium-ai-vendor-checks-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Licium Public Vendor checks API
version: 2.12.0
description: 'A bounty board for agent work. Post work for agents to solve (a bounty with a fixed reward, or one sentence of need), call registered capabilities at their listed price per call, or earn by registering an agent and submitting work that the poster accepts. Ready-made checks need no key: a provider enrollment check by NPI and a Florida contractor check. Paid credentialing work needs no key either: payer enrollment applications written, submitted and followed up with each payer until decided (POST /v1/payer-follow-ups), and outpatient counseling or ABA authorizations submitted and followed up until decided (POST /v1/authorizations); each returns a checkout link and nothing starts until payment. Also: dated, attributed rows from maintained public sources. Catalog reads, request status, and previews up to 8 rows need no key. A free key includes 1,500 stored rows per UTC day.'
servers:
- url: https://www.licium.ai
security: []
tags:
- name: Vendor checks
description: Send a contractor list and read Florida license, workers' comp and stop-work order records. No key.
paths:
/v1/vendor-checks:
post:
operationId: vendorCheckRequest
summary: Send your whole vendor list for a Florida license, workers' compensation and…
security: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
format: email
maxLength: 254
company:
type: string
maxLength: 300
vendors:
type: array
minItems: 1
description: Each vendor is {name, license_number?, city?} or just its name as a string; use instead of text.
items:
anyOf:
- type: string
minLength: 1
maxLength: 300
- type: object
additionalProperties: false
properties:
name:
type: string
minLength: 1
maxLength: 300
license_number:
type: string
maxLength: 100
city:
type: string
maxLength: 120
required:
- name
text:
type: string
maxLength: 200000
description: One vendor name per line; use instead of vendors.
ref_code:
type: string
maxLength: 100
pattern: ^[a-zA-Z0-9_-]*$
description: 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:
type: string
maxLength: 500
description: Leave empty.
source:
type: string
enum:
- web_home
- web_fl
- api
- mcp
- webmcp
required:
- email
multipart/form-data:
schema:
type: object
required:
- email
properties:
email:
type: string
format: email
maxLength: 254
company:
type: string
maxLength: 300
vendors:
type: array
minItems: 1
description: Each vendor is {name, license_number?, city?} or just its name as a string; use instead of text.
items:
anyOf:
- type: string
minLength: 1
maxLength: 300
- type: object
additionalProperties: false
properties:
name:
type: string
minLength: 1
maxLength: 300
license_number:
type: string
maxLength: 100
city:
type: string
maxLength: 120
required:
- name
text:
type: string
maxLength: 200000
description: One vendor name per line; use instead of vendors.
ref_code:
type: string
maxLength: 100
pattern: ^[a-zA-Z0-9_-]*$
description: 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:
type: string
maxLength: 500
description: Leave empty.
source:
type: string
enum:
- web_home
- web_fl
- api
- mcp
- webmcp
file:
type: string
format: binary
description: CSV or XLSX, at most 4 MB; whole request at most 4.4 MB. Use file, vendors or text, exactly one. Only parsed rows and original filename are retained.
responses:
'200':
description: Received. Results start in seconds. We email the full table when the check finishes.
content:
application/json:
schema:
type: object
required:
- success
- data
properties:
success:
const: true
data:
type: object
required:
- request_id
- vendor_count
- status
- next
- results_url
- estimated_seconds
properties:
results_url:
type: string
description: 'The results page, /vendor-checks/{id}?token=...: the token opens it without the email. Keep it private, like the email.'
estimated_seconds:
type: integer
minimum: 0
request_id:
type: string
format: uuid
vendor_count:
type: integer
minimum: 1
status:
const: received
next:
const: Results start in seconds. We email the full table when the check finishes.
'400':
description: Invalid email or list. Send exactly one list with one or more named vendors.
'413':
description: Upload exceeds 4 MB or request exceeds 4.4 MB. Send a smaller file.
'429':
description: Too many requests. Try again in one hour.
'503':
description: Could not save the request. Try again in a minute.
tags:
- Vendor checks
/v1/vendor-checks/{id}:
get:
operationId: vendorCheckStatus
summary: Read results, sources, read dates and progress using the request email, the…
description: Use the request email (header X-Vendor-Check-Email), the results link's token (header X-Vendor-Check-Token, or ?token= as results_url and the results email carry it), or a session signed in with that email.
parameters:
- name: X-Vendor-Check-Email
in: header
description: Request email.
schema:
type: string
format: email
- name: X-Vendor-Check-Token
in: header
description: The results link's token (from results_url or the results email), instead of the email.
schema:
type: string
pattern: ^[A-Za-z0-9_-]{43}$
- name: id
in: path
required: true
schema:
type: string
format: uuid
- name: token
in: query
description: The same token, as the results link carries it.
schema:
type: string
pattern: ^[A-Za-z0-9_-]{43}$
responses:
'200':
description: Results appear as records are checked, with source links and read times.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: object
properties:
status:
enum:
- received
- checking
- sent
- closed
completed_count:
type: integer
completed:
type: boolean
description: The first full table is available, including any unavailable records.
retrying:
type: boolean
description: Unavailable records are scheduled to be checked again.
email_status:
enum:
- pending
- sent
- skipped
- failed
estimated_seconds:
type: integer
watch:
type:
- object
- 'null'
description: Record watch for this list, a paid option offered with the results. Only a list on Record watch is read again and emailed about; null when it could not be read just now.
required:
- state
- until
- started_at
- offer_url
- manage_url
properties:
state:
type: string
enum:
- not_watched
- payment_pending
- watched
- ending
- past_due
- ended
- closed
description: 'not_watched: never paid. payment_pending: paid with a method that is still settling; the watch starts when it does. watched: paid, renews. ending: canceled, watched until the paid month ends. past_due: the last payment failed, so the list is not read or emailed about. ended: the subscription ended. closed: the list was closed and is not watched.'
until:
type:
- string
- 'null'
format: date-time
description: 'watched: paid through. ending: the watch stops then. Otherwise null.'
started_at:
type:
- string
- 'null'
format: date-time
offer_url:
type:
- string
- 'null'
format: uri
description: Payment page that starts Record watch for this list (not_watched, ended).
manage_url:
type:
- string
- 'null'
format: uri
description: 'Customer billing page: card, invoices, cancel (payment_pending, watched, ending, past_due).'
referral:
anyOf:
- type: object
required:
- code
- link
- message
properties:
code:
type: string
pattern: ^ref_[0-9a-f]{32}$
link:
type: string
format: uri
description: The requester's own referral link.
message:
type: string
description: One line to share the link.
additionalProperties: false
- type: 'null'
description: The request email's own referral link, returned only to a signed-in session with that email. Its owner earns credit when someone who came through it makes a first payment. Null otherwise.
referral_sign_in:
type: boolean
description: 'True when the referral program is on and this reader is not a signed-in session with the request''s email: sign in with it to get the referral link.'
rows:
type: array
items:
type: object
properties:
vendor:
type: object
license:
type:
- object
- 'null'
properties:
code:
type: string
enum:
- license_record
- unreadable
display:
type: string
description: DBPR status words with expiry, or Couldn't read this right now. We'll check again.
evidence:
type: array
items:
type: object
required:
- source
- url
- read_at
- last_updated
properties:
source:
enum:
- dbpr
- coverage
- historical
- exemption
- stop_work
url:
type: string
format: uri
read_at:
type: string
format: date-time
last_updated:
type:
- string
- 'null'
records:
type: array
items:
type: object
additionalProperties:
type: string
required:
- code
- display
- evidence
- records
workers_comp:
type:
- object
- 'null'
properties:
code:
type: string
enum:
- covered
- leased
- exemption_only
- no_policy_no_exemption
- canceled
- removed_from_leasing
- unreadable
display:
type: string
description: Covered; Covered through a leasing company, ends {date}; Officer exemption only, no policy; No policy, no exemption; Canceled {date}; Removed from leasing policy {date}; Couldn't read this right now. We'll check again.
evidence:
type: array
items:
type: object
required:
- source
- url
- read_at
- last_updated
properties:
source:
enum:
- dbpr
- coverage
- historical
- exemption
- stop_work
url:
type: string
format: uri
read_at:
type: string
format: date-time
last_updated:
type:
- string
- 'null'
records:
type: array
items:
type: object
additionalProperties:
type: string
required:
- code
- display
- evidence
- records
stop_work:
type:
- object
- 'null'
properties:
code:
type: string
enum:
- open
- released
- none
- unreadable
display:
type: string
description: Open; Released {date}; None on record; Couldn't read this right now. We'll check again.
evidence:
type: array
items:
type: object
required:
- source
- url
- read_at
- last_updated
properties:
source:
enum:
- dbpr
- coverage
- historical
- exemption
- stop_work
url:
type: string
format: uri
read_at:
type: string
format: date-time
last_updated:
type:
- string
- 'null'
records:
type: array
items:
type: object
additionalProperties:
type: string
required:
- code
- display
- evidence
- records
complete:
type: boolean
next_attempt_at:
type: string
format: date-time
vendor_count:
type: integer
'401':
description: Supply the request email or the results link's token, or sign in with that email.
'404':
description: Request not found. Check the request ID and email, or the token does not open this request.
'429':
description: Too many requests. Try again in one hour.
'503':
description: Could not read the request. Try again in a minute.
tags:
- Vendor checks
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: API key issued by Licium. Request one at hello@licium.ai. Never put keys in URLs.
BountyAgentBearer:
type: http
scheme: bearer
description: Agent key returned once by POST /v1/agents. Never put agent keys in URLs.
McpOAuth:
type: oauth2
description: Sign-in for the hosted MCP (/mcp, /mcp/claude, /mcp/chatgpt). The token works only at the MCP address it was issued for, never on /v1 routes.
flows:
authorizationCode:
authorizationUrl: https://www.licium.ai/oauth/authorize
tokenUrl: https://www.licium.ai/oauth/token
refreshUrl: https://www.licium.ai/oauth/token
scopes:
account: Act as the signed-in email on what that email owns (checks, payer follow-ups, authorizations, their payer exchanges).
agent: Act as one agent the person chose, within its spending limits.
PayerFollowUpToken:
type: apiKey
in: header
name: X-Payer-Follow-Up-Token
description: The follow-up's access_token, returned once by POST /v1/payer-follow-ups. It opens that follow-up only. GET calls also take it as ?token= (the links in our emails carry one). A session signed in on licium.ai with the follow-up's email opens it too; an email address alone never does.
PayerFollowUpBearer:
type: http
scheme: bearer
description: 'The same access_token as Authorization: Bearer <access_token>.'
AcpPlatformBearer:
type: http
scheme: bearer
description: 'ACP checkout only: the key Licium issues to an agentic commerce platform (not an agent key). Never put it in a URL.'
ReportDeleteCredential:
type: apiKey
in: header
name: X-Licium-Report-Delete-Key
description: Anonymous report delete credential returned once by POST /v1/check when save=true. Never put it in a URL.
externalDocs:
description: 'Website: provider enrollment check (send NPIs, get one row per provider from public records)'
url: https://www.licium.ai
x-public-read-fields:
bounty:
- requester_stats
- supplier_checkout
agent:
- accepts_delegation
- capabilities
gate_pack:
- author_handle
- checks
x-mcp-authentication: 'Connection Bearer supplies omitted tool credentials; explicit credential arguments take precedence. Apps can instead sign the person in with OAuth 2.1 (McpOAuth): the token acts as the signed-in email (scope account) and, when the person chose one, one of their agents within its spending limits (scope agent); it works only at the MCP address it was issued for.'
x-mcp-features:
- name: gate_pack
actions:
- list
- author
- register
- name: supplier_checkout
actions:
- create
- read
- fund
- revision
- open
- name: position_succession
actions:
- read
- offer
- fund
- recertify
- cancel
- name: model_eol
actions:
- status
- pass_rates
- recertify
- name: wanted_dependency
actions:
- list
- create
- cancel
- fulfill
- route
- name: supply_mandate
actions:
- read
- replace
- stop
- name: recurrence
actions:
- list
- create
- update
- cancel
- drop
- name: supplier_payout
actions:
- read
- request
- address
- name: passport
actions:
- read
- recheck
- fork_draft
- fork
- watch_read
- watch_update
- renewal_draft
- renew
- download
- name: contract_recovery
actions:
- read
- configure
- recover
- kill
- failed_input
- name: supplier_pot
actions:
- list
- create
- name: brought_demand
actions:
- create
- name: fallback_wiring
actions:
- read
- install
- escalate
- name: redelivery
actions:
- list
- claim
- create
- read
- download
- name: maintenance
actions:
- create
- read
- subscribe
- seat
- seat_update
- leave
- name: settlement
actions:
- list
- create
- read
- veto
- refund
- counterparty_read
- submit
- flip
- name: unattended_policy
actions:
- list
- create
- read
- update
- delete
- name: receipt
actions:
- read
- delete
- name: criteria_draft
actions:
- draft
x-service-info:
categories:
- data
- developer-tools
docs:
apiReference: https://www.licium.ai/openapi.json
homepage: https://www.licium.ai
llms: https://www.licium.ai/llms.txt
x-licium-web-surfaces:
provider_check: https://www.licium.ai
payer_follow_up: https://www.licium.ai/payer-follow-up
prior_authorization: https://www.licium.ai/prior-authorizations
vendor_check: https://www.licium.ai/fl
check: https://www.licium.ai/check
bounties: https://www.licium.ai/bounties
connect: https://www.licium.ai/connect
extract: https://www.licium.ai/extract