---
title: "List views"
method: GET
path: "/api/v2/projects/{projectKey}/views"
tags: ["Views (beta)"]
---

# List views

`GET /api/v2/projects/{projectKey}/views`

Get a list of all views in the given project.

## Path parameters

- `projectKey` string, required

## Query parameters

- `sort` 'key' | 'name' | 'updatedAt'
- `limit` integer
- `offset` integer
- `filter` string
- `expand` string[]

## Headers

- `LD-API-Version` 'beta', required

## Response `200`

Successful response

- Views
  - `_links` ViewsPaginatedLinks
    - `first` ViewsLink
      - `href` string
      - `type` string
    - `last` ViewsLink
      - `href` string
      - `type` string
    - `next` ViewsLink
      - `href` string
      - `type` string
    - `prev` ViewsLink
      - `href` string
      - `type` string
    - `self` ViewsLink, required
      - `href` string
      - `type` string
  - `items` View[], required
    - `_access` ViewsAccessRep
      - `denied` ViewsAccessDenied[], required
        - `action` string, required
        - `reason` ViewsAccessDeniedReason, required
          - `resources` string[] — Resource specifier strings
          - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
          - `actions` ActionSpecifier[] — Actions to perform on a resource
          - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
          - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
          - `role_name` string
      - `allowed` ViewsAccessAllowedRep[], required
        - `action` string, required
        - `reason` ViewsAccessAllowedReason, required
          - `resources` string[] — Resource specifier strings
          - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
          - `actions` ActionSpecifier[] — Actions to perform on a resource
          - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
          - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
          - `role_name` string
    - `_links` ParentAndSelfLinks — The location and content type of related resources
      - `self` CoreLink, required
        - `href` string, required
        - `type` string, required
      - `parent` CoreLink, required
        - `href` string, required
        - `type` string, required
    - `id` string, string, required — Unique ID of this view
    - `accountId` string, required — ID of the account that owns this view
    - `projectId` string, required — ID of the project this view belongs to
    - `projectKey` string, required — Key of the project this view belongs to
    - `key` string, required — Unique key for the view within the account/project
    - `name` string, required — Human-readable name for the view
    - `description` string, required — Optional detailed description of the view
    - `generateSdkKeys` boolean, required — Whether to generate SDK keys for this view. Defaults to false.
    - `version` integer, required — Version number for tracking changes
    - `tags` string[], required — Tags associated with this view
    - `createdAt` integer, required
    - `updatedAt` integer, required
    - `archived` boolean, required — Whether this view is archived
    - `archivedAt` integer
    - `deletedAt` integer
    - `deleted` boolean, required — Whether this view is deleted
    - `maintainer` Maintainer
      - `id` string, required
      - `kind` string, required
      - `maintainerMember` ViewsMaintainerMember
        - `id` string, required
        - `email` string, required
        - `role` string, required
        - `firstName` string
        - `lastName` string
      - `maintainerTeam` ViewsMaintainerTeam
        - `id` string, required
        - `key` string, required
        - `name` string, required
    - `flagsSummary` FlagsSummary
      - `count` integer, required
      - `linkedFlags` ExpandedDirectlyLinkedFlags
        - `items` ExpandedDirectlyLinkedFlag[], required
          - `key` string, required
          - `name` string, required
          - `links` ViewsSelfLink, required
            - `self` CoreLink, required
              - …
        - `totalCount` integer, required
    - `segmentsSummary` SegmentsSummary
      - `count` integer, required
      - `linkedSegments` ExpandedDirectlyLinkedSegments
        - `items` ExpandedDirectlyLinkedSegment[], required
          - `key` string, required
          - `name` string, required
          - `environmentId` string, required
          - `links` ViewsSelfLink, required
            - `self` CoreLink, required
              - …
        - `totalCount` integer, required
    - `metricsSummary` MetricsSummary
      - `count` integer, required
    - `aiConfigsSummary` AIConfigsSummary
      - `count` integer, required
    - `resourceSummary` ResourceSummary
      - `flagCount` integer, required
      - `segmentCount` integer
      - `metricCount` integer
      - `aiConfigCount` integer
      - `totalCount` integer, required
    - `flagsExpanded` ExpandedLinkedFlags — Details on linked flags for a view - requires passing the 'allFlags' expand field
      - `items` ExpandedFlag[], required
        - `key` string, required — A unique key used to reference the flag
        - `name` string, required — A human-friendly name for the flag
        - `description` string — Description of the flag
        - `creationDate` integer — Creation date in milliseconds
        - `_version` integer — Version of the flag
        - `archived` boolean — Whether the flag is archived
        - `tags` string[] — Tags for the flag
        - `temporary` boolean — Whether the flag is temporary
        - `includeInSnippet` boolean — Whether to include in snippet
        - `maintainer` ExpandedFlagMaintainer
          - `key` string, required — The ID of the maintainer member, or the key of the maintainer team
          - `kind` 'member' | 'team', required — The type of the maintainer
          - `_member` ViewsMemberSummary
            - `_links` object, required — The location and content type of related resources
            - `_id` string, required — The member's ID
            - `firstName` string — The member's first name
            - `lastName` string — The member's last name
            - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
            - `email` string, required — The member's email address
          - `_team` ViewsMemberTeamSummaryRep
            - `customRoleKeys` string[], required — A list of keys of the custom roles this team has access to
            - `key` string, required — The team key
            - `_links` object
            - `name` string, required — The team name
        - `_links` ParentAndSelfLinks — The location and content type of related resources
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
          - `parent` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
    - `segmentsExpanded` ExpandedLinkedSegments — Details on linked segments for a view - requires passing the 'allSegments' expand field
      - `items` ExpandedSegment[], required
        - `key` string, required — A unique key used to reference the segment
        - `name` string, required — A human-friendly name for the segment
        - `environmentId` string — Environment ID of the segment
        - `environmentKey` string — Environment key of the segment
        - `description` string — Description of the segment
        - `creationDate` integer — Creation date in milliseconds
        - `lastModifiedDate` integer — Last modification date in milliseconds
        - `deleted` boolean — Whether the segment is deleted
        - `tags` string[] — Tags for the segment
        - `unbounded` boolean — Whether the segment is unbounded
        - `version` integer — Version of the segment
        - `generation` integer — Generation of the segment
        - `_links` ParentAndSelfLinks — The location and content type of related resources
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
          - `parent` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
    - `metricsExpanded` ExpandedLinkedMetrics
      - `items` ExpandedMetric[], required
        - `key` string — A unique key used to reference the metric
        - `name` string — A human-friendly name for the metric
        - `creationDate` integer — Creation date in milliseconds
        - `lastModified` integer — Last modification date in milliseconds
        - `isActive` boolean — Whether the metric is active
        - `eventKey` string — Event key for the metric
        - `_id` string — ID of the metric
        - `_versionId` string — Version ID of the metric
        - `kind` string — Kind of the Metric
        - `category` string — Category of the Metric
        - `description` string — Description of the Metric
        - `isNumeric` boolean
        - `lastSeen` integer — Last seen date in milliseconds
        - `_links` ParentAndSelfLinks — The location and content type of related resources
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
          - `parent` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
    - `aiConfigsExpanded` ExpandedLinkedAIConfigs
      - `items` ExpandedAIConfig[], required
        - `key` string — A unique key used to reference the AI config
        - `name` string — A human-friendly name for the AI config
        - `tags` string[] — Tags for the AI config
        - `description` string — Description of the AI config
        - `version` integer — Version of the AI config
        - `createdAt` integer — Creation date in milliseconds
        - `updatedAt` integer — Last modification date in milliseconds
        - `flagKey` string — Key of the flag that this AI config is attached to
        - `_links` ParentAndSelfLinks — The location and content type of related resources
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
          - `parent` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
    - `resourcesExpanded` ExpandedLinkedResources — Details on linked resources for a view - requires passing the 'allResources' expand field
      - `items` ExpandedLinkedResourcesItems, required
        - `flags` ExpandedLinkedResourcesFlags, required
          - `items` ExpandedFlag[], required
            - `key` string, required — A unique key used to reference the flag
            - `name` string, required — A human-friendly name for the flag
            - `description` string — Description of the flag
            - `creationDate` integer — Creation date in milliseconds
            - `_version` integer — Version of the flag
            - `archived` boolean — Whether the flag is archived
            - `tags` string[] — Tags for the flag
            - `temporary` boolean — Whether the flag is temporary
            - `includeInSnippet` boolean — Whether to include in snippet
            - `maintainer` ExpandedFlagMaintainer
              - …
            - `_links` ParentAndSelfLinks — The location and content type of related resources
              - …
          - `totalCount` integer, required
        - `segments` ExpandedLinkedResourcesSegments
          - `items` ExpandedSegment[], required
            - `key` string, required — A unique key used to reference the segment
            - `name` string, required — A human-friendly name for the segment
            - `environmentId` string — Environment ID of the segment
            - `environmentKey` string — Environment key of the segment
            - `description` string — Description of the segment
            - `creationDate` integer — Creation date in milliseconds
            - `lastModifiedDate` integer — Last modification date in milliseconds
            - `deleted` boolean — Whether the segment is deleted
            - `tags` string[] — Tags for the segment
            - `unbounded` boolean — Whether the segment is unbounded
            - `version` integer — Version of the segment
            - `generation` integer — Generation of the segment
            - `_links` ParentAndSelfLinks — The location and content type of related resources
              - …
          - `totalCount` integer, required
        - `aiConfigs` ExpandedLinkedResourcesAIConfigs
          - `items` ExpandedAIConfig[], required
            - `key` string — A unique key used to reference the AI config
            - `name` string — A human-friendly name for the AI config
            - `tags` string[] — Tags for the AI config
            - `description` string — Description of the AI config
            - `version` integer — Version of the AI config
            - `createdAt` integer — Creation date in milliseconds
            - `updatedAt` integer — Last modification date in milliseconds
            - `flagKey` string — Key of the flag that this AI config is attached to
            - `_links` ParentAndSelfLinks — The location and content type of related resources
              - …
          - `totalCount` integer, required
        - `metrics` ExpandedLinkedResourcesMetrics
          - `items` ExpandedMetric[], required
            - `key` string — A unique key used to reference the metric
            - `name` string — A human-friendly name for the metric
            - `creationDate` integer — Creation date in milliseconds
            - `lastModified` integer — Last modification date in milliseconds
            - `isActive` boolean — Whether the metric is active
            - `eventKey` string — Event key for the metric
            - `_id` string — ID of the metric
            - `_versionId` string — Version ID of the metric
            - `kind` string — Kind of the Metric
            - `category` string — Category of the Metric
            - `description` string — Description of the Metric
            - `isNumeric` boolean
            - `lastSeen` integer — Last seen date in milliseconds
            - `_links` ParentAndSelfLinks — The location and content type of related resources
              - …
          - `totalCount` integer, required
      - `totalCount` integer, required
  - `totalCount` integer, required

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-02-28** `69c5c9aafe78` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/changes/api/v2/projects/:projectKey/views/get.md)

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)