---
title: "List views"
method: GET
path: "/api/v1/views"
tags: ["Visibility & Mentions"]
---

# List views

`GET /api/v1/views`

## Request

- Base URL: `https://app.promptingco.com`
- URL: `https://app.promptingco.com/api/v1/views`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Lists the organization's views, newest first, each with its brand and conversationCount. Filter by brandId; search matches name or description. page is one-based.

## Query parameters

- `page` integer
- `pageSize` integer
- `search` string
- `brandId` string

## Response `200`

Successful response

- object
  - `ok` true, required
  - `data` object, required
    - `data` object[], required
      - `id` string, required
      - `name` string, required
      - `description` string, nullable, required
      - `brandId` string, required
      - `organizationId` string, nullable, required
      - `isDefault` boolean, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string, nullable, required
      - `conversationCount` integer
      - `brand` object
        - `id` string, required
        - `name` string, required
        - `slug` string, nullable, required
    - `totalPages` integer, required
    - `totalItems` integer, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Not found
- `422`: Validation failed
- `500`: Internal server error

---

[API](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api.md) - [All operations](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/revisions/c0451ea10e9a?raw)