---
title: Get Features by Project
slug: feature-experimentation/api/get-features-by-project
docTags:
createdAt: 2026-10-01T19:58:02.336Z
---
{
"id": "4gmpxS3C490hDSrKvRd66",
"type": "api-oas-v2",
"data": {
"method": "GET",
"url": "https://api.optimizely.com/v2/features",
"servers": [
{
"url": "https://api.optimizely.com/v2/features"
}
],
"name": "Get Features by Project",
"description": "Get all of the Features that have been created in a given Project. Note this endpoint is incompatible with Full Stack Targeted Rollouts projects\n(default in accounts created after July 2020) and with non-legacy Full Stack projects (default in projects created after February 2021).\nSee the compatible API at https://library.optimizely.com/docs/api/flags/v1/index.html#tag/Flags.
",
"contentType": "application/json",
"request": {
"pathParameters": [],
"headerParameters": [
{
"name": "accept",
"type": "string",
"kind": "optional",
"description": "Generated from available response content types",
"enum": [
"application/json"
],
"default": "application/json"
}
],
"queryParameters": [
{
"kind": "optional",
"name": "per_page",
"type": "integer",
"description": "Optional pagination argument that specifies the maximum number of objects to return per request",
"default": 25,
"maximum": 100
},
{
"kind": "optional",
"name": "page",
"type": "integer",
"description": "Optional pagination argument that specifies the page to return. If you have 140 objects and you choose to return 100 objects per page you will be able to access the last 40 objects on page 2. The default value is 1.\n",
"default": 1
},
{
"kind": "required",
"name": "project_id",
"type": "integer",
"description": "The ID of the project for which you would like to get Features",
"format": "int64"
}
],
"bodyDataParameters": [],
"formDataParameters": [],
"oAuthParameters": [
{
"id": "apiKey",
"name": "apiKey",
"kind": "optional",
"type": "http",
"scheme": "bearer"
},
{
"id": "OAuth2",
"name": "OAuth2",
"kind": "optional",
"type": "oauth2",
"description": "Write applications that authenticate with the REST API via OAuth 2.0. Or, to authenticate using a personal token, see https://docs.developers.optimizely.com/web/docs/personal-token
",
"oauth2Flows": {
"authorizationCode": {
"authorizationUrl": "https://app.optimizely.com/oauth2/authorize",
"tokenUrl": "https://app.optimizely.com/oauth2/token",
"scopes": {
"all": "Full access to your account"
}
}
},
"requiredScopes": [
"read",
"write"
]
}
],
"cookieParameters": []
},
"responses": [
{
"statusCode": "200",
"description": "Return all Features in a specified Project",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "array",
"description": "",
"customType": "Feature[]",
"schema": [
{
"name": "archived",
"kind": "optional",
"type": "boolean",
"description": "Whether the Feature has been archived",
"default": false
},
{
"name": "created",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "Time when the Feature was created",
"format": "date-time"
},
{
"name": "description",
"kind": "optional",
"type": "string",
"description": "A short description of this Feature"
},
{
"name": "environments",
"kind": "optional",
"type": "map",
"description": "The configuration for this Feature's Rollout within each Environment, keyed by Environment key
",
"example": "",
"customType": "map",
"schema": []
},
{
"name": "id",
"kind": "optional",
"type": "integer",
"readOnly": true,
"description": "The ID of this Feature",
"format": "int64"
},
{
"name": "key",
"kind": "required",
"type": "string",
"description": "Unique string identifier for this Feature within the Project",
"example": "new_checkout_page",
"maxLength": 64,
"pattern": "^[a-zA-Z0-9_\\-]+$"
},
{
"name": "last_modified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "Date last modified",
"format": "date-time"
},
{
"name": "name",
"kind": "optional",
"type": "string",
"description": "Name of the Feature",
"example": "the checkout feature"
},
{
"name": "project_id",
"kind": "required",
"type": "integer",
"description": "The ID of the Project this Feature belongs to",
"format": "int64"
},
{
"name": "variables",
"kind": "optional",
"type": "array",
"description": "Variables define the dynamic configuration of a feature, and each variable can take on a different value on a per-variation basis within a feature test.
",
"modelRef": "#/components/schemas/FeatureVariable",
"customType": "FeatureVariable[]",
"schema": [
{
"name": "archived",
"kind": "optional",
"type": "boolean",
"description": "Whether or not this Feature Variable is archived",
"default": false
},
{
"name": "default_value",
"kind": "required",
"type": "string",
"description": "The stringified default value for this Feature Variable. The default value is the value Optimizely SDKs will return when this Feature Variable is accessed by getFeatureVariableValue unless the Feature Variable's value is a part of a feature test variation.",
"example": "0.05"
},
{
"name": "id",
"kind": "optional",
"type": "integer",
"readOnly": true,
"description": "The ID of this Feature Variable",
"format": "int64"
},
{
"name": "key",
"kind": "required",
"type": "string",
"description": "Unique string identifier for this Feature Variable within the Feature"
},
{
"name": "type",
"kind": "required",
"type": "string",
"description": "The datatype for this Feature Variable",
"example": "double",
"enum": [
"boolean",
"string",
"double",
"integer",
"json"
]
}
]
}
],
"modelRef": "#/components/schemas/Feature",
"isExpanded": true
}
]
},
{
"statusCode": "401",
"description": "Invalid credentials",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"customType": "Error",
"schema": [
{
"name": "code",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "message",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "messages",
"kind": "optional",
"type": "object",
"description": "",
"example": "",
"schema": []
},
{
"name": "uuid",
"kind": "optional",
"type": "string",
"description": "",
"format": "uuid"
}
],
"modelRef": "#/components/schemas/Error",
"isExpanded": true
}
]
},
{
"statusCode": "403",
"description": "You do not have permission to access to the Features in the specified Project",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"customType": "Error",
"schema": [
{
"name": "code",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "message",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "messages",
"kind": "optional",
"type": "object",
"description": "",
"example": "",
"schema": []
},
{
"name": "uuid",
"kind": "optional",
"type": "string",
"description": "",
"format": "uuid"
}
],
"modelRef": "#/components/schemas/Error",
"isExpanded": true
}
]
},
{
"statusCode": "default",
"description": "Unexpected error",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"customType": "Error",
"schema": [
{
"name": "code",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "message",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "messages",
"kind": "optional",
"type": "object",
"description": "",
"example": "",
"schema": []
},
{
"name": "uuid",
"kind": "optional",
"type": "string",
"description": "",
"format": "uuid"
}
],
"modelRef": "#/components/schemas/Error",
"isExpanded": true
}
]
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "vcl8kuzO2N_beY7U8Uym9",
"language": "curl",
"label": "cURL",
"code": "curl --request GET \\\n --url 'https://api.optimizely.com/v2/features?per_page=25&page=1&project_id=integer%3Cint64%3E' \\\n --header 'accept: application/json'"
},
{
"id": "LIDK45kO5zcIXzYe-xz42",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://api.optimizely.com/v2/features?per_page=25&page=1&project_id=integer\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "uLCCDtBeH5lguVnXjOV3V",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.optimizely.com/v2/features?per_page=25&page=1&project_id=integer\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
},
{
"id": "34W70MDYYBg5LkBoyxGT5",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"https://api.optimizely.com/v2/features?per_page=25&page=1&project_id=integer\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "vcl8kuzO2N_beY7U8Uym9"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// Return all Features in a specified Project\n[\n {\n \"archived\": false,\n \"created\": \"\",\n \"description\": \"\",\n \"environments\": \"\",\n \"id\": \"\",\n \"key\": \"new_checkout_page\",\n \"last_modified\": \"\",\n \"name\": \"the checkout feature\",\n \"project_id\": \"\",\n \"variables\": [\n {\n \"archived\": false,\n \"default_value\": \"0.05\",\n \"id\": \"\",\n \"key\": \"\",\n \"type\": \"double\"\n }\n ]\n }\n]"
},
{
"id": "response-1-401",
"language": "401",
"code": "// Invalid credentials\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-2-403",
"language": "403",
"code": "// You do not have permission to access to the Features in the specified Project\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-3-default",
"language": "default",
"code": "// Unexpected error\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}