TX Vendor Directory (CMBL) (tx-cmbl-vendors)

The Texas Comptroller's CMBL vendor directory - the state's master list of businesses registered to sell to Texas government - returned as a queryable vendor profile: HUB / SDV / small-business / QISV / veteran flags, NIGP capability by class and item, and a VPTS performance grade linked by exact vendor ID.

Use this to find and vet the vendor, not to find the bid.

Low cost

From $0.0035 per vendor record - you are charged per vendor record delivered, never for the query itself. Runs are capped at $5, so a broad filter can't run up a bill. Default output is 50 records.

What you get

{
  "platform": "tx-cmbl",
  "vendorId": "1700123456789",
  "vendorNumber": "170012345",
  "name": "GULF COAST MARINE LLC",
  "description": "",
  "address": { "addr1": "", "addr2": "", "city": "Aransas Pass",
               "state": "TX", "zip": "78336", "county": "ARANSAS" },
  "contact": "", "phone": "", "fax": "", "email": "", "website": "",
  "flags": {
    "hub": { "status": "A", "approved": true, "expireDate": "2026-11-30" },
    "sdv": false, "smallBusiness": true, "qisv": false, "veteran": false,
    "cmblActive": true, "cmblExpireDate": "2027-06-09", "txOffice": true
  },
  "category": { "code": "05", "name": "Architectural / Engineering and Surveying Services" },
  "performance": {
    "commodity": { "orderCount": null, "deliveryScore": null, "perfScore": null },
    "service":   { "orderCount": null, "deliveryScore": null, "perfScore": null }
  },
  "nigp": [
    { "class": "906", "className": "ARCHITECTURAL SERVICES, PROFESSIONAL",
      "items": [2, 4, 6], "districts": [1, 2, 3] }
  ],
  "vpts": {
    "vendorId": "17001234567", "vendorName": "GULF COAST MARINE LLC",
    "grade": "B", "reportCount": "1", "datePublished": "3/10/2026"
  }
}

Top-level fields: platform, vendorId, vendorNumber, name, description, address (object), contact, phone, fax, email, website, flags (object), category (object), performance (object), nigp (array of class objects), vpts (object or null).

Note the shapes: address is nested (not top-level city/state), flags.hub is a status object (not a boolean), nigp items are objects carrying the class's item and district bitmaps, and the performance grade lives in vpts.grade - not in performance, which is the state's CMBL order-scoring block.

Why the vendor ID matters

vendorId is the 13-digit CMBL vendor identifier, and it is the same key the state's VPTS performance register uses. That makes the link between a vendor and their performance record an exact identifier join - not a name match - so a vendor either has a real grade or vpts is null, and it is never a guess.

That is the structural difference from the awards actor, which can only match winners by name.

Filters

Filter	What it does
keywords	Free-text over vendor name and related fields.
hubApproved / sdv / smallBusiness	Business-classification flags.
activeOnly	Currently-active registrations only.
nigpCodes / categoryCodes / nigpKeyword	NIGP capability - by code, by class, or by keyword over the NIGP description.
city / county / state / highwayDistricts	Geography.
⚠️ qisv / veteran	Present in the schema but the source's QISV_FLAG / VETERAN columns are unpopulated (0 of 45,484 rows carry a value), so these filters always return nothing. Kept for when the state fills them in.
includeVpts / vptsOnly / hasPerformanceScore / minPerfScore	Performance-grade selection.
maxResults	Output cap. Default 50.

Example inputs

Architecture firms:

{ "keywords": ["architecture"], "maxResults": 25 }

HUB-certified vendors that can supply dental services - nigpKeyword searches the NIGP dictionary by plain words:

{ "hubApproved": true, "nigpKeyword": ["dental"] }

Small businesses in one county that have a performance record:

{ "smallBusiness": true, "county": "Harris", "vptsOnly": true }

Who is currently registered for an NIGP class:

{ "nigpCodes": ["906"], "activeOnly": true }

Read the VPTS coverage correctly

The VPTS register covers roughly 5,900 vendors over a four-year window, so about 13% of active CMBL vendors have a performance record. Vendors without one come back with vpts: null - that is no record, not a poor grade.

Example output

{"keywords": ["architecture"]} - one vendor card, with the VPTS grade attached by exact vendor ID:

{
  "platform": "tx-cmbl",
  "vendorId": "1273176862300",
  "vendorNumber": "507129",
  "name": "STUDIO OUTSIDE",
  "description": "Landscape Architecture, Urban Design, Master Planning, Garden Design",
  "address": {
    "addr1": "824 EXPOSITION AVE STE 5",
    "addr2": "",
    "city": "DALLAS",
    "state": "TX",
    "zip": "75226-2498",
    "county": "DALLAS"
  },
  "contact": "Stacy Marshall",
  "phone": "214-954-7160",
  "fax": "",
  "email": "smarshall@studiooutside.us",
  "website": "",
  "flags": {
    "hub": {
      "status": "N",
      "approved": false,
      "expireDate": ""
    },
    "sdv": false,
    "smallBusiness": false,
    "qisv": false,
    "veteran": false,
    "cmblActive": true,
    "cmblExpireDate": "2027-06-09",
    "txOffice": false
  },
  "category": {
    "code": "05",
    "name": "Architectural / Engineering and Surveying Services"
  },
  "performance": {
    "commodity": {
      "orderCount": null,
      "deliveryScore": null,
      "perfScore": null
    },
    "service": {
      "orderCount": null,
      "deliveryScore": null,
      "perfScore": null
    }
  },
  "nigp": [
    {
      "class": "906",
      "className": "ARCHITECTURAL SERVICES, PROFESSIONAL",
      "items": [
        2,
        4,
        6,
        7,
        25,
        29,
        56,
        64,
        66,
        88
      ],
      "districts": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25
      ]
    }
  ],
  "vpts": {
    "vendorId": "12731768623",
    "vendorName": "Studio Outside, LLC",
    "grade": "B",
    "reportCount": "1",
    "datePublished": "3/10/2026"
  }
}

The rest of the Texas family

Your goal	Actor
Find bids by keyword, NIGP, agency, status	tx-esbd-search
Check one specific bid by its number	tx-esbd-get
Monitor new & changed solicitations on a schedule	tx-esbd-changes
Who won state contracts, at what amounts	tx-esbd-awards
Find / vet a vendor - HUB, SDV, small business, NIGP capability	tx-cmbl-vendors - you are here
Find disabled-veteran (DV) HUB vendors	tx-hub-certified
Statewide contracts - who's on each SPD/TxSmartBuy contract	tx-smartbuy-contracts
Pull the raw full corpus (query + monitor) - power users	sled-tx-procurement

Typical questions

• "Which HUB-certified vendors can supply NIGP 12021?"
• "Give me small-business vendors in Harris County with a performance grade above 80."
• "What is this vendor's CMBL registration profile and performance grade?"

Notes

• Data source: Texas Comptroller CMBL (vendor registration) + TxSmartBuy VPTS (vendor performance). Public state records; CMBL refreshes nightly.
• No login, no anti-bot - built from the official public CSV exports.
• The vendor register is periodically refreshed from source; if the upstream export is unavailable the actor serves the last verified copy and marks the output sourceIsStale.

License

MIT - see ./LICENSE.

Disclaimer

This product is an independent data service and is not affiliated with, endorsed by, or sponsored by the State of Texas or any government agency. All vendor data is public government information.