{
  "openapi": "3.0.1",
  "info": {
    "title": "Poland Car & EV Registrations API – CEPiK Official Stats",
    "description": "Monthly counts of cars and EVs registered in Poland by brand, model, fuel and region (official CEPiK data). Aggregates only, no VINs or owners. Default input counts electric passenger cars in Mazovia (code 14). For all fuels nationwide set fuelType ANY and voivodeships [].",
    "version": "0.1",
    "x-build-id": "8hz3uo1XgbhLpkBdB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/enterprising_hamster~polish-vehicle-registrations-cepik/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-enterprising_hamster-polish-vehicle-registrations-cepik",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/enterprising_hamster~polish-vehicle-registrations-cepik/runs": {
      "post": {
        "operationId": "runs-sync-enterprising_hamster-polish-vehicle-registrations-cepik",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/enterprising_hamster~polish-vehicle-registrations-cepik/run-sync": {
      "post": {
        "operationId": "run-sync-enterprising_hamster-polish-vehicle-registrations-cepik",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "monthFrom": {
            "title": "From month",
            "pattern": "^(\\d{4}-(0[1-9]|1[0-2]))?$",
            "type": "string",
            "description": "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)."
          },
          "monthTo": {
            "title": "To month",
            "pattern": "^(\\d{4}-(0[1-9]|1[0-2]))?$",
            "type": "string",
            "description": "Last month, YYYY-MM. Months are reported newest first. At most 60 months per run."
          },
          "areaLevel": {
            "title": "Area level",
            "enum": [
              "POLAND",
              "VOIVODESHIP"
            ],
            "type": "string",
            "description": "Report one total for Poland (or for the selected voivodeships together) or one block of rows per voivodeship.",
            "default": "POLAND"
          },
          "voivodeships": {
            "title": "Voivodeships (regions)",
            "type": "array",
            "description": "Default is [\"14\"], Mazovia. Send the code from enumTitles, for example 14, not the region name. An empty list is the whole country and reads 17 areas.",
            "items": {
              "type": "string",
              "enum": [
                "02",
                "04",
                "06",
                "08",
                "10",
                "12",
                "14",
                "16",
                "18",
                "20",
                "22",
                "24",
                "26",
                "28",
                "30",
                "32",
                "XX"
              ],
              "enumTitles": [
                "02 DOLNOŚLĄSKIE",
                "04 KUJAWSKO-POMORSKIE",
                "06 LUBELSKIE",
                "08 LUBUSKIE",
                "10 ŁÓDZKIE",
                "12 MAŁOPOLSKIE",
                "14 MAZOWIECKIE",
                "16 OPOLSKIE",
                "18 PODKARPACKIE",
                "20 PODLASKIE",
                "22 POMORSKIE",
                "24 ŚLĄSKIE",
                "26 ŚWIĘTOKRZYSKIE",
                "28 WARMIŃSKO-MAZURSKIE",
                "30 WIELKOPOLSKIE",
                "32 ZACHODNIOPOMORSKIE",
                "XX NIEOKREŚLONE"
              ]
            },
            "default": [
              "14"
            ]
          },
          "groupBy": {
            "title": "Group by",
            "type": "array",
            "description": "Columns to count by. Empty = one total per month and area (fastest: counts come straight from the API without reading records).",
            "items": {
              "type": "string",
              "enum": [
                "brand",
                "model",
                "fuelType",
                "alternativeFuel",
                "powertrain",
                "vehicleType",
                "origin",
                "condition",
                "productionYear",
                "county"
              ],
              "enumTitles": [
                "Make (marka)",
                "Model",
                "Primary fuel",
                "Alternative fuel (hybrids show ENERGIA ELEKTRYCZNA)",
                "Powertrain: ELECTRIC, HYBRID, PETROL, DIESEL, GAS, HYDROGEN, OTHER",
                "Vehicle type",
                "Origin (new/used, bought in Poland/imported)",
                "NEW / USED / OTHER",
                "Production year",
                "County (powiat), needs area level Voivodeship"
              ]
            },
            "default": [
              "brand",
              "model"
            ]
          },
          "vehicleType": {
            "title": "Vehicle type",
            "enum": [
              "ANY",
              "PASSENGER_CAR",
              "TRUCK",
              "MOTORCYCLE",
              "MOPED",
              "BUS",
              "ROAD_TRACTOR",
              "AGRICULTURAL_TRACTOR",
              "SPECIAL_VEHICLE",
              "LIGHT_TRAILER",
              "TRAILER",
              "SEMI_TRAILER",
              "AGRICULTURAL_TRAILER"
            ],
            "type": "string",
            "description": "Count only this vehicle type (exact CEPiK value).",
            "default": "PASSENGER_CAR"
          },
          "fuelType": {
            "title": "Primary fuel",
            "enum": [
              "ANY",
              "PETROL",
              "DIESEL",
              "ELECTRIC",
              "LPG",
              "CNG",
              "LNG",
              "HYDROGEN",
              "BIODIESEL",
              "ETHANOL",
              "PETROL_OIL_MIX",
              "OTHER",
              "NOT_APPLICABLE"
            ],
            "type": "string",
            "description": "Default ELECTRIC returns only vehicles whose primary fuel is electric. Set ANY for every fuel. Hybrids are stored under a non-electric primary fuel such as petrol or diesel, with electric as the alternative fuel, so they stay out of the result while this field is ELECTRIC. Set ANY and add powertrain to groupBy to count them.",
            "default": "ELECTRIC"
          },
          "origin": {
            "title": "Origin",
            "enum": [
              "ANY",
              "NEW_BOUGHT_IN_POLAND",
              "NEW_IMPORTED",
              "USED_BOUGHT_IN_POLAND",
              "USED_IMPORTED",
              "RE_REGISTRATION",
              "REGISTRATION_OFFICE_CHANGE",
              "RECOVERED_AFTER_THEFT",
              "ENTRUSTED_BY_FOREIGN_ENTITY",
              "BOUGHT_FROM_STATE_SERVICES",
              "FORFEITED_TO_STATE"
            ],
            "type": "string",
            "description": "Default ANY includes used imports and re-registrations. For new cars bought in Poland set NEW_BOUGHT_IN_POLAND.",
            "default": "ANY"
          },
          "brand": {
            "title": "Make",
            "type": "string",
            "description": "Optional exact make as registered, e.g. TOYOTA (case does not matter)."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Optional exact model as registered, e.g. MODEL Y."
          },
          "dateBasis": {
            "title": "Date basis",
            "enum": [
              "FIRST_REGISTRATION_IN_POLAND",
              "LAST_REGISTRATION"
            ],
            "type": "string",
            "description": "Which registration date puts a vehicle in a month.",
            "default": "FIRST_REGISTRATION_IN_POLAND"
          },
          "onlyCurrentlyRegistered": {
            "title": "Only vehicles still registered",
            "type": "boolean",
            "description": "CEPiK's default: count only vehicles that are registered today. Turn off to include vehicles deregistered since.",
            "default": true
          },
          "topN": {
            "title": "Top N rows per month and area",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Keep only the N largest groups per month and area. 0 = all groups.",
            "default": 0
          },
          "minRegistrations": {
            "title": "Minimum registrations per row",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Skip groups smaller than this.",
            "default": 1
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Hard cap of dataset rows (each row is one charged event).",
            "default": 100
          },
          "onlyNew": {
            "title": "Only new or changed rows",
            "type": "boolean",
            "description": "Skip rows already delivered by an earlier run with the same state key and the same count. Useful for schedules.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name of the remembered set of delivered rows (letters, digits, - and _)."
          },
          "cacheTtlHours": {
            "title": "Cache lifetime (hours)",
            "minimum": 0,
            "maximum": 720,
            "type": "integer",
            "description": "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.",
            "default": 24
          },
          "maxRequestsPerSecond": {
            "title": "Max requests per second",
            "minimum": 0.2,
            "maximum": 3,
            "type": "number",
            "description": "Politeness limit towards api.cepik.gov.pl. Requests are always sent one at a time.",
            "default": 1
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}