---
title: "Vendor VMScore lookup by license number"
method: GET
path: "/api/v1/vendors"
tags: ["Vendors"]
---

# Vendor VMScore lookup by license number

`GET /api/v1/vendors`

## Request

- Base URL: `https://www.venumark.com`
- URL: `https://www.venumark.com/api/v1/vendors`
- Auth: HTTP bearer

Returns the VMScore, risk tier, recommendation, and 12-month violation rollup counts for a Florida DBPR-licensed vendor (license types 2014 mobile food / 2013 caterer). For itemized violation and inspection history use the anonymous /api/vendors/{id}/scorecard endpoint. Platform reliability is included only when the vendor has applied to events on VenuMark. Useful for pre-screening before sending an invite.

## Query parameters

- `license_number` string, required

## Response `200`

Vendor VMScore record.

- VendorEnvelope
  - `data` VendorScore, required: Vendor VMScore record derived from Florida DBPR public inspection data. Field names are snake_case.
    - `vendor_id` string, nullable
    - `license_number` string: Normalized license number: digits only, prefix stripped.
    - `business_name` string, nullable
    - `location_city` string, nullable
    - `county_name` string, nullable
    - `vm_score` number, nullable: 0-100 composite VMScore.
    - `risk_tier` string, nullable: Letter grade tier.
    - `recommendation` string, nullable
    - `trend` string, nullable
    - `has_hold` boolean, nullable
    - `hold_reasons` unknown
    - `confidence` unknown
    - `inspections_12mo` integer, nullable
    - `violations_12mo` integer, nullable
    - `failed_inspections_12mo` integer, nullable
    - `last_inspection_date` string, nullable
    - `reliability` object, nullable: Platform reliability rollup; null unless the vendor has applied to events on VenuMark.
      - `total_recorded` number
      - `attended_12mo` number
      - `no_show_12mo` number
      - `late_12mo` number
      - `early_leave_12mo` number
      - `on_time_pct_12mo` number
      - `last_outcome_at` string, nullable
  - `meta` EnvelopeMeta, nullable: Optional response metadata, e.g. {count}. List endpoints are unpaginated and return the full result set. Null when not applicable.
  - `error` unknown, required

## Other responses

- `400`: Missing or invalid query parameter.
- `401`: Missing, malformed, invalid, or revoked API key.
- `404`: Resource not found or not owned by the authenticated account.
- `429`: Rate limit exceeded (60 requests per minute per key).

---

[API](https://skmtc.dev/venumark/apis/venumark-read-api.md) · [All operations](https://skmtc.dev/venumark/apis/venumark-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/venumark/apis/venumark-read-api/revisions/3bd019092f9c?raw)