---
title: "List apps & meta sites"
method: GET
path: "/api/meta-sites/v1/apps-with-meta-sites"
tags: ["Meta sites"]
---

# List apps & meta sites

`GET /api/meta-sites/v1/apps-with-meta-sites`

## Request

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

Get list of apps with meta sites. App with `demo` type will be always first on the list if exists (sorting method is irrelevant)


Full example:
```
/api/meta-sites/v1/apps-with-meta-sites?offset=100&limit=10&search=nifty+marketing&action=edit
```
this will list 10 apps and meta sites which I have access to (can execute `edit` action) starting on 101th matching search query "nifty marketing".

## Query parameters

- `offset` integer
- `limit` integer
- `search` string
- `sort` 'name' | 'type' | 'created_at' | '-name' | '-type' | '-created_at'
- `action` 'view' | 'edit'

## Response `200`

OK

- object
  - `meta` object, required: Metadata of a listing
    - `total` integer, required: Total number of items
  - `data` object[], required
    - `type` 'ppms/app' | 'ppms/meta-site', required: Resource type
    - `id` string, uuid, required: UUIDv4 identifier of an object
    - `attributes` object, required
      - `name` string, required: App or Meta Site name
      - `created_at` string, date-time, required: Timestamp of object's creation

## Other responses

- `400`: Bad Request

## Changes

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

[Operation history](https://skmtc.dev/piwik/apis/web-api/changes/api/meta-sites/v1/apps-with-meta-sites/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)