> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List QR Codes (minimal)

> GET /qr/minimal/

A light listing shape for QR Code pickers and dropdowns — the same filtering as [List QR Codes](/api-reference/management-api/qr/list) with far fewer fields per row.

```
GET    https://api.scanova.io/qr/minimal/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<Note>
  Permission here is an **OR** of the analytics-view, QR-edit, and lead-generation roles rather than `QR_CODE_CAN_VIEW` alone. A user who can only read analytics or manage leads can still populate a QR Code selector with this endpoint.
</Note>

### Query parameters

<ParamField query="withlead" type="integer">
  Set to `1` to return the with-lead shape instead, which adds `lead_id` and `form_id` to each row.
</ParamField>

<ParamField query="user_quota" type="string">
  Pass `NON_LANDING_PAGE_QR_CODES` to exclude landing-page and GS1 categories — useful when the picker is for a feature those categories don't support.
</ParamField>

<ParamField query="search" type="string">
  Free-text search, same fields as the main list endpoint.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.scanova.io/qr/minimal/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
    -d withlead=1
  ```
</RequestExample>

## Related

* [List QR Codes](/api-reference/management-api/qr/list) — the full list shape, with the complete filter set.
* [List QR categories](/api-reference/management-api/qr/category-list) — resolve the `category_slug` values returned here.
* [QR Manager overview](/api-reference/management-api/qr/overview) — the quotas, role permissions, and Trash model shared by every endpoint in this module.
* [Management API overview](/api-reference/management-api/overview) — the auth scheme and quota rules that apply to this endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /qr/minimal/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /qr/minimal/:
    get:
      summary: List QR codes (minimal shape)
      description: >-
        A deliberately light listing for pickers and dropdowns. Permission is an
        OR of the analytics-view, QR-edit, and lead-generation roles, so a user
        who can only read analytics can still populate a QR selector. Pass
        `?withlead=1` to include the attached lead list and form ids.
      operationId: listQrCodesMinimal
      parameters:
        - name: withlead
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Set to `1` to switch to the with-lead shape, adding `lead_id` and
            `form_id` to each row.
        - name: user_quota
          in: query
          required: false
          schema:
            type: string
          description: >-
            Pass `NON_LANDING_PAGE_QR_CODES` to exclude landing-page and GS1
            categories from the result.
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: Free-text search, same fields as the main list endpoint.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Page number.
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 10
          description: Results per page, maximum `100`.
      responses:
        '200':
          description: Paginated minimal list of QR codes.
          content:
            application/json:
              example:
                count: 214
                next: 2
                previous: null
                results:
                  - id: 1042
                    qrid: Qa1b2c3d4e5f6g7h8
                    name: Product Launch Poster
                    qr_type: dy
                    qr_type_display: Dynamic
                    short_url: https://scnv.io/a1b2c3d4
                    thumbnail: null
                    is_active: true
                    published_at: '2026-01-15T09:14:00Z'
                    category_slug: url
                    is_currently_draft: false
                    has_landing_page: false
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````