---
title: "Apps list"
method: GET
path: "/api/apps/v2"
tags: ["Apps"]
---

# Apps list

`GET /api/apps/v2`

## Request

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

Get list of apps<br><br>
Full example:
```
/api/apps/v2?offset=100&limit=10&sort=name&search=nifty+marketing&permission=view
```
this will list 10 apps ordered ascending by `name` starting on 101th matching search query "nifty marketing".

## Query parameters

- `offset` integer
- `limit` integer
- `search_query` string
- `sort` 'name' | 'addedAt' | 'updatedAt' | '-name' | '-addedAt' | '-updatedAt'
- `search` string
- `permission` 'view' | 'edit' | 'publish' | 'manage'

## Response `200`

OK

- object
  - `meta` object
    - `total` integer: Total count of objects
  - `data` object[]
    - `type` 'ppms/app': Resource type
    - `id` string, uuid: Resource ID
    - `attributes` object
      - `name` string: App name
      - `addedAt` string, date-time: When app was added
      - `updatedAt` string, date-time: When app was edited

## Changes

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

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