v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB
Approvals

Get approval request

Get an approval request by approval request ID.

Expanding approval response

LaunchDarkly supports the expand query param to include additional fields in the response, with the following fields:

  • environments includes the environments the approval request relates to
  • flag includes the flag the approval request belongs to
  • project includes the project the approval request belongs to
  • resource includes details on the resource (flag or segment) the approval request relates to

For example, expand=project,flag includes the project and flag fields in the response.

get/api/v2/approval-requests/{id}

Path parameters

idstring string required

The approval request ID

The approval request ID

Query parameters

expandstring string

A comma-separated list of fields to expand in the response. Supported fields are explained above.

A comma-separated list of fields to expand in the response. Supported fields are explained above.

Response

Approval request response

_idstring required

The ID of this approval request

_versioninteger required

Version of the approval request

creationDateinteger required
serviceKindstring required
requestorIdstring

The ID of the member who requested the approval

descriptionstring

A human-friendly name for the approval request

reviewStatus'approved' | 'declined' | 'pending' required

Current status of the review of this approval request

notifyMemberIdsstring[] required

An array of member IDs. These members are notified to review the approval request.

appliedDateinteger
appliedByMemberIdstring

The member ID of the member who applied the approval request

appliedByServiceTokenIdstring

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

instructionsInstruction[] required
_linksobject required

The location and content type of related resources

executionDateinteger
operatingOnIdstring

ID of scheduled change to edit or delete

resourceIdstring

String representation of a resource