---
title: List Subject Access Requests
slug: web-experimentation/api/list-subject-access-requests
docTags:
createdAt: 2026-10-02T13:15:18.296Z
---
{
"id": "_OyCICTJ2lkseXSZWkkQb",
"type": "api-oas-v2",
"data": {
"method": "GET",
"url": "https://api.optimizely.com/v2/subject-access-requests",
"servers": [
{
"url": "https://api.optimizely.com/v2/subject-access-requests"
}
],
"name": "List Subject Access Requests",
"description": "Fetch Subject Access Requests submitted from your account",
"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
}
],
"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 Subject Access Request info",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "array",
"description": "",
"customType": "SubjectAccessRequest[]",
"schema": [
{
"name": "account_id",
"kind": "optional",
"type": "integer",
"readOnly": true,
"description": "The Account ID for the account the Subject Access Request will be executed.",
"example": 12345,
"format": "int64"
},
{
"name": "completed_at_time",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The time when the request was completed.",
"format": "date-time"
},
{
"name": "data_type",
"kind": "required",
"type": "string",
"description": "",
"example": "user",
"enum": [
"user",
"visitor"
]
},
{
"name": "expired_at_time",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "Time when the url expires (7 days from the completed_at_time)
",
"format": "date-time"
},
{
"name": "export_location",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The location to which the data will be exported. The data will be made accessible in a AWS S3 bucket.",
"example": "https://s3-us-west-2.amazonaws.com/optimizely-sar-prod/{account-id}-{request_id}.zip"
},
{
"name": "id",
"kind": "optional",
"type": "integer",
"readOnly": true,
"description": "The Subject Access Request ID.",
"example": 12345,
"format": "int64"
},
{
"name": "identifier",
"kind": "required",
"type": "string",
"description": "The identifier value that you would like us to use when searching. If user was selected in the previous step, the identifier will be the email address for the User.
",
"example": "test@optimizely.com",
"maxLength": 355
},
{
"name": "identifier_type",
"kind": "required",
"type": "string",
"description": "",
"example": "email",
"enum": [
"email",
"optimizely_end_user_id",
"dcp_id",
"fullstack_id",
"other"
]
},
{
"name": "processing_started_time",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The time when the processing of the Subject Access Request started.",
"format": "date-time"
},
{
"name": "request_type",
"kind": "required",
"type": "string",
"description": "delete - Removes all data within an account that is associated to the identifier defined in the identifier field.\n\n\naccess - Finds all data stored in Optimizely systems associated to the identifier defined in the identifier field and exports it to an AWS S3 bucket for you to access.
",
"example": "access",
"enum": [
"access",
"delete"
]
},
{
"name": "requested_at_time",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The time when the Subject Access Request was submitted.",
"format": "date-time"
},
{
"name": "sla_deadline_time",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The time by which the Subject Access Request must be completed.",
"format": "date-time"
},
{
"name": "status",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The status of the Subject Access Request.",
"example": "pending",
"enum": [
"pending",
"processing",
"completed",
"failure"
]
}
],
"modelRef": "#/components/schemas/SubjectAccessRequest",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "Invalid ID supplied",
"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": "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 the specified subject access request",
"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": "404",
"description": "Subject Access Request not found",
"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": "KwkZbcGThK0FSRUJG9mj8",
"language": "curl",
"label": "cURL",
"code": "curl --request GET \\\n --url 'https://api.optimizely.com/v2/subject-access-requests?per_page=25&page=1' \\\n --header 'accept: application/json'"
},
{
"id": "zsVa6nyozz4H9dlx4Vrcf",
"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/subject-access-requests?per_page=25&page=1\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "-ooD7mfpkg4cFi9AKulzb",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.optimizely.com/v2/subject-access-requests?per_page=25&page=1\")\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": "wRAdjgBRm-PAy8hjWQp1Y",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"https://api.optimizely.com/v2/subject-access-requests?per_page=25&page=1\"\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": "KwkZbcGThK0FSRUJG9mj8"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// Return Subject Access Request info\n[\n {\n \"account_id\": 12345,\n \"completed_at_time\": \"\",\n \"data_type\": \"user\",\n \"expired_at_time\": \"\",\n \"export_location\": \"https://s3-us-west-2.amazonaws.com/optimizely-sar-prod/{account-id}-{request_id}.zip\",\n \"id\": 12345,\n \"identifier\": \"test@optimizely.com\",\n \"identifier_type\": \"email\",\n \"processing_started_time\": \"\",\n \"request_type\": \"access\",\n \"requested_at_time\": \"\",\n \"sla_deadline_time\": \"\",\n \"status\": \"pending\"\n }\n]"
},
{
"id": "response-1-400",
"language": "400",
"code": "// Invalid ID supplied\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-2-401",
"language": "401",
"code": "// Invalid credentials\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-3-403",
"language": "403",
"code": "// You do not have permission to access the specified subject access request\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-4-404",
"language": "404",
"code": "// Subject Access Request not found\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
},
{
"id": "response-5-default",
"language": "default",
"code": "// Unexpected error\n{\n \"code\": \"\",\n \"message\": \"\",\n \"messages\": {},\n \"uuid\": \"\"\n}"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}