Chicago Public Chauffeur Portfolio Status Monitor

Watch named Chicago BACP Public Chauffeur license numbers against the official data.cityofchicago.org Socrata dataset 97wa-y6ff.

Who this is for: taxi/livery fleet compliance officers, commercial auto insurers writing named-driver taxi/livery policies, BACP-regulated affiliation companies, hotels/hospitals contracting livery, and vendor-risk desks that need recurring alerts when a named Chicago Public Chauffeur licence appears, drops, or changes status (ACTIVE / EXPIRED / SUSPENDED / REVOKED / DENIED / …) or name / city / expires / driver_type attributes.

Billable events (PPE chicago-chauffeur-status-event-delivered @ $0.02):

• APPEARED / DROPPED
• STATUS_CHANGED (ACTIVE / EXPIRED / DENIED / SUSPENDED / PENDING / INACTIVE / REVOKED / SURRENDER)
• Attribute changes (name / city-state / expires / driver_type) when signalGroups includes attributes

Non-billable: RUN_STATUS (FIXTURE_HEALTH, MONITOR_IDLE, CATCHUP_COMPLETE, HEALTH_OK). Quiet books stay free.

Not Chicago PPV vehicle licences (tfm3-3j95). Not cryptic Chicago Business Licenses (r5kz-chrr AAI/AAC). Not a citywide dump billed as rows — watchlist $where only.

Quick start

1. Replace the example licenseNumbers with your watchlist (digits as published, e.g. 2604).
2. Set sourceMode = live.
3. Save as an Actor Task and schedule (e.g. daily).
4. First run vs later runs: run 1 baselines named licenses (no change events, no product charge). Run 2+ emit diffs against that checkpoint — keep the same Task.

Default sourceMode=fixture is a free health check (one non-billable RUN_STATUS row), not product data.

What you get per $0.02 event

One delivered unique change for a named Chicago Public Chauffeur license (APPEARED / DROPPED / STATUS_CHANGED / attribute change). Never charged: RUN_STATUS, baselines, quiet MONITOR_IDLE, fixture SAMPLE rows.

Example output (SAMPLE)

SAMPLE — illustrative field shape; not a real event:

{
  "license_number": "SAMPLE01",
  "event_type": "STATUS_CHANGED",
  "previous_value": "ACTIVE",
  "new_value": "REVOKED",
  "billable": false,
  "sample": true,
  "summary": "SAMPLE (fixture demo data with placeholder entities, not a real event)"
}

Input

• licenseNumbers — list of chauffeur license numbers (aliases: licenses, licenseNos, recordIds, credentials)
• sourceMode — fixture (free health check) | live (official Chicago BACP)
• signalGroups — directory, status, attributes

Source

• Official Socrata: https://data.cityofchicago.org/resource/97wa-y6ff.json
• Durable key: license (~30,172 unique)
• Status enum: ACTIVE / EXPIRED / DENIED / SUSPENDED / PENDING / INACTIVE / REVOKED / SURRENDER
• Driver types: TAXI / LIVERY ONLY / PEDICAB / HORSE-DRAWN ONLY
• Cadence honesty: data.cityofchicago.org / BACP republish (not a real-time push)

Pricing

Event	USD
chicago-chauffeur-status-event-delivered	$0.02
apify-actor-start	$0.00005

Limitations

• Source lag follows BACP / data.cityofchicago.org republish cadence; not instant.
• Covers person chauffeur licences, not Public Passenger Vehicle (medallion/vehicle) licences.
• Historical / expired licences remain in the published table with status EXPIRED (DROPPED only when the row disappears from the snapshot).