---
title: "List approval requests for a flag"
method: GET
path: "/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests"
tags: ["Approvals"]
---

# List approval requests for a flag

`GET /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests`

Get all approval requests for a feature flag.

## Path parameters

- `projectKey` string, string, required — The project key
- `featureFlagKey` string, string, required — The feature flag key
- `environmentKey` string, string, required — The environment key

## Response `200`

Approval request collection response

- FlagConfigApprovalRequestsResponse
  - `items` FlagConfigApprovalRequestResponse[], required — An array of approval requests
    - `_id` string, required — The ID of this approval request
    - `_version` integer, required — Version of the approval request
    - `creationDate` integer, required
    - `serviceKind` string, required
    - `requestorId` string — The ID of the member who requested the approval
    - `description` string — A human-friendly name for the approval request
    - `reviewStatus` 'approved' | 'declined' | 'pending', required — Current status of the review of this approval request
    - `allReviews` ReviewResponse[], required — An array of individual reviews of this approval request
      - `_id` string, required — The approval request ID
      - `kind` 'approve' | 'decline' | 'comment', required — The type of review action to take
      - `creationDate` integer
      - `comment` string — A comment describing the approval response
      - `memberId` string — ID of account member that reviewed request
      - `serviceTokenId` string — ID of account service token that reviewed request
    - `notifyMemberIds` string[], required — An array of member IDs. These members are notified to review the approval request.
    - `appliedDate` integer
    - `appliedByMemberId` string — The member ID of the member who applied the approval request
    - `appliedByServiceTokenId` string — The service token ID of the service token which applied the approval request
    - `status` 'pending' | 'completed' | 'failed' | 'scheduled', required — Current status of the approval request
    - `instructions` Instruction[], required
    - `conflicts` Conflict[], required — Details on any conflicting approval requests
      - `instruction` Instruction
      - `reason` string — Reason why the conflict exists
    - `_links` object, required — The location and content type of related resources
    - `executionDate` integer
    - `operatingOnId` string — ID of scheduled change to edit or delete
    - `integrationMetadata` IntegrationMetadata
      - `externalId` string, required
      - `externalStatus` IntegrationStatus, required
        - `display` string, required
        - `value` string, required
      - `externalUrl` string, required
      - `lastChecked` integer, required
    - `source` CopiedFromEnv
      - `key` string, required — Key of feature flag copied
      - `version` integer — Version of feature flag copied
    - `customWorkflowMetadata` CustomWorkflowMeta
      - `name` string — The name of the workflow stage that required this approval request
      - `stage` CustomWorkflowStageMeta
        - `index` integer — The zero-based index of the workflow stage
        - `name` string — The name of the workflow stage
  - `_links` object, required — The location and content type of related resources

## Other responses

- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `429` — Rate limited

---

[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)