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