---
title: "Get scan analytics for a dynamic code"
method: GET
path: "/v1/dynamic/{id}/scans"
---

# Get scan analytics for a dynamic code

`GET /v1/dynamic/{id}/scans`

## Path parameters

- `id` string, required

## Query parameters

- `days` integer

## Response `200`

Scan summary.

- object
  - `id` string
  - `slug` string
  - `short_url` string, uri
  - `destination` string, uri
  - `scans` object
    - `total` integer
    - `last7` integer
    - `topCountry` string, nullable
    - `topDevice` string, nullable
  - `analytics` object — Detailed breakdowns over the window (default 30 days, ?days=).
    - `days_window` integer
    - `total` integer
    - `window_total` integer
    - `daily` object[]
      - `day` string
      - `n` integer
    - `by_country` object[]
      - `value` string
      - `n` integer
    - `by_device` object[]
      - `value` string
      - `n` integer
    - `by_referrer` object[]
      - `value` string
      - `n` integer

## Other responses

- `401` — The `Authorization: Bearer oqr_…` header is missing or the API key is invalid or revoked.
- `404` — The referenced code, folder or theme doesn't exist or isn't owned by your API key.
- `500` — An unexpected server-side error.

---

[API](https://skmtc.net/openqr/apis/openqr-api.md) · [All operations](https://skmtc.net/openqr/apis/openqr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openqr/openqr-api/versions/706b4ff45a32/schema)
