---
title: "Get Property Stats"
method: GET
path: "/website/{hostname}/properties"
tags: ["Stats"]
---

# Get Property Stats

`GET /website/{hostname}/properties`

Get a list of custom properties and their stats. If a property name is provided, it will return the stats for that property instead.

## Path parameters

- `hostname` string, hostname, required

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `path` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `referrer` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_source` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_medium` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_campaign` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `browser` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `os` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `device` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `country` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `language` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `prop_name` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `prop_value` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `limit` integer
- `offset` integer

## Cookies

- `_me_sess` string, required

## Response `200`

OK

- object[] — List of custom properties and their stats.
  - `name` string — Custom property name.
  - `value` string — Custom property value.
  - `events` integer, required — Number of events for custom property.
  - `events_percentage` number, float, required — Percentage of events for custom property relative to all events.

## Other responses

- `400` — 400 Bad Request.
- `401` — 401 Unauthorised.
- `403` — 403 Forbidden.
- `404` — 404 Not Found.
- `500` — 500 Unexpected Internal Server Error.

---

[API](https://skmtc.net/medama-io/apis/medama-analytics-api.md) · [All operations](https://skmtc.net/medama-io/apis/medama-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/medama-io/medama-analytics-api/versions/77bbbf562f15/schema)