For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • REST API overview
    • Access Tokens
    • Account Members
    • Account Usage Beta
    • AI Configs
    • Announcements
    • Applications Beta
    • Approvals
      • POSTApply approval request
      • POSTApply approval request for a flag
      • POSTCreate approval request
      • POSTCreate approval request for a flag
      • POSTCreate approval request to copy flag configurations across environments
      • DELDelete approval request
      • DELDelete approval request for a flag
      • GETGet approval request
      • GETGet approval request for a flag
      • GETList approval requests
      • GETList approval requests for a flag
      • POSTReview approval request
      • POSTReview approval request for a flag
    • Approvals Beta
    • Audit Log
    • Code References
    • Contexts
    • Context Settings
    • Custom Roles
    • Data Export Destinations
    • Environments
    • Experiments
    • Feature Flags
    • Feature Flags Beta
    • Flag Import Configurations Beta
    • Flag Links Beta
    • Flag Triggers
    • Follow Flags
    • Holdouts Beta
    • Insights Charts Beta
    • Insights Deployments Beta
    • Insights Flag Events Beta
    • Insights Pull Requests Beta
    • Insights Repositories Beta
    • Insights Scores Beta
    • Integration Audit Log Subscriptions
    • Integration Delivery Configurations Beta
    • Integrations Beta
    • Layers
    • Metrics
    • Metrics Beta
    • OAuth2 Clients
    • Persistent Store Integrations Beta
    • Projects
    • Relay Proxy Configurations
    • Release Pipelines Beta
    • Releases Beta
    • Scheduled Changes
    • Segments
    • Tags
    • Teams
    • Teams Beta
    • Users
    • Users Beta
    • User Settings
    • Views Beta
    • Webhooks
    • Workflows
    • Workflow Templates
    • Other
Sign inTry it free
LogoLogo
REST API overviewApprovals

List approval requests for a flag

GET
/api/v2/projects/:projectKey/flags/:featureFlagKey/environments/:environmentKey/approval-requests
GET
/api/v2/projects/:projectKey/flags/:featureFlagKey/environments/:environmentKey/approval-requests
$curl https://app.launchdarkly.com/api/v2/projects/projectKey/flags/featureFlagKey/environments/environmentKey/approval-requests \
>     -H "Authorization: <apiKey>"
1{
2  "items": [
3    {
4      "_id": "12ab3c45de678910abc12345",
5      "_version": 1,
6      "creationDate": 1654104600000,
7      "serviceKind": "launchdarkly",
8      "reviewStatus": "pending",
9      "allReviews": [
10        {
11          "_id": "12ab3c45de678910abc12345",
12          "kind": "approve",
13          "creationDate": 1653606981113,
14          "comment": "Approved!",
15          "memberId": "12ab3c45de678910abc12345",
16          "serviceTokenId": "12ab3c45de678910abc12345"
17        }
18      ],
19      "notifyMemberIds": [
20        "1234a56b7c89d012345e678f"
21      ],
22      "status": "pending",
23      "instructions": [
24        "[{\"kind\": \"turnFlagOn\"}]"
25      ],
26      "conflicts": [
27        {
28          "instruction": {},
29          "reason": "string"
30        }
31      ],
32      "_links": {},
33      "requestorId": "12ab3c45de678910abc12345",
34      "description": "example: request approval from someone",
35      "appliedDate": 1654104600000,
36      "appliedByMemberId": "1234a56b7c89d012345e678f",
37      "appliedByServiceTokenId": "1234a56b7c89d012345e678f",
38      "executionDate": 1654104600000,
39      "operatingOnId": "12ab3c45de678910abc12345",
40      "integrationMetadata": {
41        "externalId": "string",
42        "externalStatus": {
43          "display": "string",
44          "value": "string"
45        },
46        "externalUrl": "string",
47        "lastChecked": 1
48      },
49      "source": {
50        "key": "source-flag-key-123abc",
51        "version": 1
52      },
53      "customWorkflowMetadata": {
54        "name": "Example workflow name",
55        "stage": {
56          "index": 0,
57          "name": "Stage 1"
58        }
59      }
60    }
61  ],
62  "_links": {}
63}
Get all approval requests for a feature flag.
Was this page helpful?
Previous

Review approval request

Next
Built with

Authentication

Authorizationstring
API Key authentication via header

Path parameters

projectKeystringRequiredformat: "string"
The project key
featureFlagKeystringRequiredformat: "string"
The feature flag key
environmentKeystringRequiredformat: "string"
The environment key

Response

Approval request collection response
itemslist of objects
An array of approval requests
_linksmap from strings to objects
The location and content type of related resources

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error