GET https://experiment.amplitude.com/api/1/versionsFetch a list of versions of all experiments or flags can the management API key has access to, across multiple projects if the key scope has access to them.
| Name | Description |
|---|---|
start |
The ISO 8601 formatted start time of versions to return (inclusive). |
end |
The ISO 8601 formatted end time to versions to return (exclusive). |
limit |
The max number of deployments to return. Capped at 1000. |
cursor |
The offset to start the "page" of results from. |
A successful request returns a 200 OK response and a list of versions encoded as JSON in the response body, along with the cursor to next page.
Versions are ordered by version creation time descending.
curl --request GET \ --url 'https://experiment.amplitude.com/api/1/versions?limit=3&cursor=3000&start=2023-01-01T00:00:00Z&end=2024-12-31T23:59:59Z' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <management-api-key>'
{ "nextCursor": 3003, "versions": [ { "createdAt": "2023-07-29T03:32:49.594Z", "createdBy": <userId>, "version": 3, "flagConfig": { "id": <id>, "projectId": <projectId>, "deployments": [<deploymentId>], "key": "flag-key", "name": "flag-key", "description": "feature flag access", "enabled": true, "evaluationMode": "remote", "bucketingKey": "amplitude_id", "bucketingSalt": "mHdQDzeE", "bucketingUnit": "User", "variants": [ { "key": "on" } ], "rolloutPercentage": 0, "rolloutWeights": { "on": 1 }, "targetSegments": [ { "name": "Segment 1", "conditions": [ { "prop": "country", "op": "is", "type": "property", "values": [ "United States" ] } ], "percentage": 0, "bucketingKey": "amplitude_id", "rolloutWeights": { "on": 1 } } ] } }, {
"createdAt": "2023-07-29T03:32:39.494Z", "createdBy": <userId>, "version": 2, "flagConfig": { "id": <id>, "projectId": <projectId>, "deployments": [<deploymentId>], "key": "flag-key", "name": "flag-key", "description": "feature flag access", "enabled": false, "evaluationMode": "remote", "bucketingKey": "amplitude_id", "bucketingSalt": "mHdQDzeE", "bucketingUnit": "User", "variants": [ { "key": "on" } ], "rolloutPercentage": 0, "rolloutWeights": { "on": 1 }, "targetSegments": [ { "name": "Segment 1", "conditions": [ { "prop": "country", "op": "is", "type": "property", "values": [ "United States" ] } ], "percentage": 0, "bucketingKey": "amplitude_id", "rolloutWeights": { "on": 1 } } ] } }, { "createdAt": "2023-07-29T03:30:45.703Z", "createdBy": <userId>, "version": 1, "flagConfig": { "id": <id>, "projectId": <projectId>, "deployments": [], "key": "flag-key", "name": "flag-key", "description": "", "enabled": false, "evaluationMode": "remote", "bucketingKey": "amplitude_id", "bucketingSalt": "mHdQDzeE", "bucketingUnit": "User", "variants": [ { "key": "on" } ], "rolloutPercentage": 0, "rolloutWeights": { "on": 1 }, "targetSegments": [] } } ]}
June 4th, 2024
Need help? Contact Support
Visit Amplitude.com
Have a look at the Amplitude Blog
Learn more at Amplitude Academy
© 2025 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.