Poland Car & EV Registrations API – CEPiK Official Stats
polish-vehicle-registrations-cepikReturns monthly vehicle registration counts from CEPiK, grouped by brand, model, fuel, powertrain or region and filtered by vehicle type, fuel and date range for fleet and EV adoption statistics.
Instructions
Returns monthly vehicle registration counts from the official CEPiK open data API, grouped by brand, model, fuel, powertrain, origin, production year or county and filtered by vehicle type, fuel, origin, voivodeship and month range (at most 60 months per run); aggregates only, no VINs or owners. Defaults are electric passenger cars in Mazowieckie for the last complete month; all of Poland can take several minutes when CEPiK is busy. Use it for fleet and EV adoption statistics; for charging infrastructure use polish-ev-charging-stations-eipa. Read-only: it only queries the public source and never writes to the registry; onlyNew merely keeps a stateKey memory in your own Apify account. Each call needs the APIFY_TOKEN env var and starts one paid run of the Apify Actor enterprising_hamster/polish-vehicle-registrations-cepik on your Apify account, billed pay-per-event per delivered item plus any Apify platform usage; the server waits up to 300 s for the run and returns JSON {items, truncated} with at most maxItems (max 100) items and 256 KiB.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "polish-vehicle-registrations-cepik"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topN | No | Keep only the N largest groups per month and area. 0 = all groups. | |
| brand | No | Optional exact make as registered, e.g. TOYOTA (case does not matter). | |
| model | No | Optional exact model as registered, e.g. MODEL Y. | |
| origin | No | Count only vehicles of this origin, e.g. new cars bought in Poland or used imports. | ANY |
| groupBy | No | Columns to count by. Empty = one total per month and area (fastest: counts come straight from the API without reading records). | |
| monthTo | No | Last month, YYYY-MM. Months are reported newest first. At most 60 months per run. | |
| onlyNew | No | Skip rows already delivered by an earlier run with the same state key and the same count. Useful for schedules. | |
| fuelType | No | Count only this primary fuel. Hybrids are registered with petrol or diesel as primary fuel; use groupBy powertrain to see them. | ELECTRIC |
| maxItems | No | Hard cap of dataset rows (each row is one charged event). | |
| stateKey | No | Name of the remembered set of delivered rows (letters, digits, - and _). | |
| areaLevel | No | Report one total for Poland (or for the selected voivodeships together) or one block of rows per voivodeship. | POLAND |
| dateBasis | No | Which registration date puts a vehicle in a month. | FIRST_REGISTRATION_IN_POLAND |
| monthFrom | No | First month, YYYY-MM (e.g. 2026-01). Leave both months empty for the last complete month. With only From, the range runs to the current month (marked partialPeriod). | |
| vehicleType | No | Count only this vehicle type (exact CEPiK value). | PASSENGER_CAR |
| voivodeships | No | Default: 14 MAZOWIECKIE. Clear the field (empty list) for all of Poland (all 16 voivodeships plus records with no voivodeship, code XX); all of Poland reads 17 voivodeships and takes several minutes when CEPiK is busy. | |
| cacheTtlHours | No | Reuse breakdowns that needed more than 1,000 records and were read by an earlier run of yours within this many hours. 0 = always ask CEPiK. | |
| minRegistrations | No | Skip groups smaller than this. | |
| maxRequestsPerSecond | No | Politeness limit towards api.cepik.gov.pl. Requests are always sent one at a time. | |
| onlyCurrentlyRegistered | No | CEPiK's default: count only vehicles that are registered today. Turn off to include vehicles deregistered since. |