---
title: "Tracking endpoint"
method: GET
path: "/ppms.php"
tags: ["Tracker"]
---

# Tracking endpoint

`GET /ppms.php`

## Request

- Base URL: `https://example.piwik.pro`
- URL: `https://example.piwik.pro/ppms.php`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/auth/token`
- TypeScript: <https://skmtc.dev/piwik/apis/web-api/docs/ppms.php/get.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint tracking events (page views, goal conversions, custom events).

*IMPORTANT:* All of `string` type values HAVE TO be urlencoded in raw URL, according to https://url.spec.whatwg.org/ specification, as shown in examples. Decoded value is provided in at the end of description.

## Query parameters

- `idsite` string, UUID
- `rec` 0 | 1
- `url` string, URL
- `action_name` string
- `_id` string, hexadecimal
- `r` string
- `urlref` string, URL
- `_cvar` string, JSON
- `cvar` string, JSON
- `_idvc` integer
- `_viewts` integer
- `_idts` integer
- `res` string, {width}x{height}
- `h` integer
- `m` integer
- `s` integer
- `ua` string
- `lang` string
- `uid` string
- `cid` string, hexadecimal
- `new_visit` 0 | 1
- `dimensionID` string
- `link` string, URL
- `download` string, URL
- `search` string
- `search_cat` string
- `search_cats` string, JSON
- `search_count` integer
- `pv_id` string, hexadecimal
- `idgoal` string, uuid
- `revenue` number
- `e_t` 'order' | 'cart-update' | 'product-detail-view' | 'add-to-cart' | 'remove-from-cart'
- `ec_id` string
- `ec_items` string
- `ec_products` string, JSON
- `ec_st` number
- `ec_tx` number
- `ec_sh` number
- `ec_dt` number
- `cur` string
- `_ects` integer
- `gt_ms` integer
- `cs` string
- `cookie` 0 | 1
- `fla` 0 | 1
- `java` 0 | 1
- `dir` 0 | 1
- `qt` 0 | 1
- `realp` 0 | 1
- `pdf` 0 | 1
- `wma` 0 | 1
- `gears` 0 | 1
- `ag` 0 | 1
- `e_c` string
- `e_a` string
- `e_n` string
- `e_v` number, float
- `c_n` string
- `c_p` string
- `c_t` string
- `c_i` string
- `c_persid` string, uuid
- `send_image` 0 | 1
- `cip` union
  - string, ipv4
  - string, ipv6
- `cdt` string, UNIX timestamp|UTC DateTime<YYYY-MM-DD hh:mm:ss>
- `country` string, ISO 3166-1 alpha-2 code (lowercase)
- `city` string
- `lat` number
- `lon` number
- `uia` 0 | 1
- `dda` 0 | 1
- `ping` 1 | 2 | 3 | 4 | 5 | 6
- `t_us` integer
- `t_ue` integer
- `t_rs` integer
- `t_re` integer
- `t_ss` integer
- `t_fs` integer
- `t_ds` integer
- `t_cs` integer
- `t_ce` integer
- `t_qs` integer
- `t_as` integer
- `t_ae` integer
- `t_dl` integer
- `t_di` integer
- `t_ls` integer
- `t_le` integer
- `t_dc` integer
- `t_ee` integer
- `ts_n` string
- `ts_v` string, SemVer
- `sh` 0 | 1
- `rmip` 0 | 1

## Headers

- `User-Agent` string

## Response `202`

Request accepted and waiting for processing

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `8b8abe1ab4f1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/piwik/apis/web-api/changes/ppms.php/get.md)

---

[API](https://skmtc.dev/piwik/apis/web-api.md) - [All operations](https://skmtc.dev/piwik/apis/web-api/llms.txt) - [OpenAPI document](https://skmtc.dev/piwik/apis/web-api/revisions/8b8abe1ab4f1?raw)