Chicago Public Passenger Vehicle Portfolio Status Monitor

Watch named Chicago BACP Public Passenger Vehicle (PPV) record IDs against the official data.cityofchicago.org Socrata dataset tfm3-3j95.

Who this is for: commercial auto / fleet insurers, taxi affiliations, medallion managers, ambulance/livery operators, and lending/risk desks that need recurring alerts when a named Chicago PPV licence appears, drops, or changes status (ACTIVE / VIOLATION / INACTIVE / REVOKED / SURRENDER / FORECLOSURE / …) or company / location / vehicle attributes.

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

• APPEARED / DROPPED
• STATUS_CHANGED (ACTIVE / VIOLATION / INACTIVE / RESERVED / SURRENDER / REVOKED / HOLD / FORECLOSURE)
• Attribute changes (company / location / vehicle) when signalGroups includes attributes

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

Not cryptic Chicago Business Licenses (r5kz-chrr AAI/AAC). Not Public Chauffeurs person licences (97wa-y6ff). Not a citywide dump billed as rows — watchlist $where only.

Quick start

1. Replace the example recordIds with your watchlist ({public_vehicle_number}{VehicleType}, e.g. 1767Taxi).
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 record IDs (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 PPV record (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": "VIOLATION",
  "billable": false,
  "sample": true,
  "summary": "SAMPLE (fixture demo data with placeholder entities, not a real event)"
}

Input

• recordIds — list of PPV record IDs (aliases: licenseNumbers, licenses, credentials)
• sourceMode — fixture (free health check) | live (official Chicago BACP)
• signalGroups — directory, status, attributes

Source

• Official Socrata: https://data.cityofchicago.org/resource/tfm3-3j95.json
• Durable key: record_id (~16,328 unique = public_vehicle_number + vehicle_type)
• Status enum: ACTIVE / VIOLATION / INACTIVE / RESERVED / SURRENDER / REVOKED / HOLD / FORECLOSURE
• Cadence honesty: data.cityofchicago.org / BACP republish (not a real-time push)

Pricing

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

Limitations

• Source lag follows BACP / data.cityofchicago.org republish cadence; not instant.
• public_vehicle_number alone is not unique across vehicle types — always use record_id (or number+type).
• Covers vehicle licences (Taxi, Livery, Ambulance, Medicar, Charter Sightseeing, Pedicab, etc.), not chauffeur person licences.