---
title: "GET /v1/tiles/{workspaceName}/{tileName}/stats"
method: GET
path: "/v1/tiles/{workspaceName}/{tileName}/stats"
tags: ["Tiles"]
---

# GET /v1/tiles/{workspaceName}/{tileName}/stats

`GET /v1/tiles/{workspaceName}/{tileName}/stats`

Returns install and skill-activation usage stats for a tile (7d or 30d window).

## Path parameters

- `workspaceName` string, required
- `tileName` string, required

## Query parameters

- `period` union
  - '7d'
  - '30d'

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, required
    - `type` 'tile-stats', required
    - `attributes` object, required
      - `usage` object, required
        - `period` union, required
          - '7d'
          - '30d'
        - `installs` object, required
          - `total` integer, required
          - `active` integer, required
          - `weekly` object[], required
            - `week` string, required
            - `count` integer, required
        - `activations` object, required
          - `total` integer, required
          - `weekly` object[], required
            - `week` string, required
            - `count` integer, required
          - `skills` object[], required
            - `skill` string, required
            - `total` integer, required
            - `weekly` object[], required
              - …
            - `versions` object[], required
              - …

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-15** `d50a02b79ad3` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/url` to the response with the `403` status
- **2026-08-27** `64ef6ca73e52` — 1 info
  - added the required property `data/attributes/usage/activations/skills/items/versions` to the response with the `200` status

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/v1/tiles/:workspaceName/:tileName/stats/get.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/b777eddaa913?raw)