---
title: "List Subject Rights Requests"
method: GET
path: "/v1/subject-rights/requests"
tags: ["dsar"]
---

# List Subject Rights Requests

`GET /v1/subject-rights/requests`

## Request

- Base URL: `https://api.osano.com`
- URL: `https://api.osano.com/v1/subject-rights/requests`
- Auth: API key in header `x-osano-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/osano-api-reference/docs/v1/subject-rights/requests/get.ts> (a function with typed inputs; its response is checked against the schema)

Query for Subject Rights Requests.  Results are sorted in descending order by creation time.  The number of results returned may be controlled via the limit param, but may not exceed 500.  The "next" object in the response may be used to retrieve subsequent pages of the same resource.  Test requests are excluded unless the testRequests param is set to include or only.

## Query parameters

- `limit` integer
- `next` string
- `after` string
- `source` 'ADMIN' | 'AGENT_WEB' | 'API' | 'CMP' | 'CSV' | 'EMAIL_INTAKE' | 'WEB'
- `status` 'PENDING_EMAIL_VERIFICATION' | 'PENDING_IDENTITY_VERIFICATION' | 'IN_PROGRESS' | 'IN_REVIEW' | 'PENDING_APPEAL' | 'COMPLETED' | 'REJECTED' | 'REJECTED_AUTO'
- `requestType` 'CORRECT' | 'CUSTOM_1' | 'CUSTOM_2' | 'CUSTOM_3' | 'CUSTOM_4' | 'CUSTOM_5' | 'CUSTOM_6' | 'DELETE' | 'DO_NOT_SELL' | 'LIMIT_USE' | 'LIST_OR_CATEGORIES_OF_THIRD_PARTIES' | 'OPT_OUT' | 'OPT_OUT_OF_PROFILING' | 'OPT_OUT_OF_USING_SENSITIVE_DATA' | 'OTHER' | 'PORTABILITY' | 'RESTRICT_PROCESSING' | 'SUMMARIZE'
- `formId` integer
- `testRequests` 'exclude' | 'include' | 'only'

## Response `200`

Success

- DsarResponseList
  - `items` DsarResponse[], required
    - `dsarId` string, required
    - `status` string, required
    - `requestType` string, required
    - `requestSource` string, required
    - `notes` string
    - `dsarDetails` object
    - `due` string, date-time, required
    - `created` string, date-time, required
    - `form` object
      - `formId` integer
      - `formName` string
    - `isTest` boolean, required: True if this is a test Subject Rights Request. Test requests are excluded from reporting. This value is read-only and cannot be set or changed through the API.
  - `next` string: A token which may be appended to subsequent requests to retrieve the next page of results, i.e. ?next=...

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-06** `ac31099cf83e`: 9 info
  - added the new optional `query` request parameter `testRequests`
  - added the new enum value `ADMIN` to the `query` request parameter `source`
  - added the new enum value `AGENT_WEB` to the `query` request parameter `source`
  - added the new enum value `CUSTOM_6` to the `query` request parameter `requestType`
  - …5 more
- **2026-05-12** `4fc37598750d`: 1 warning
  - for the `query` request parameter `limit`, the min was set to `1.00`
- **2025-10-11** `5ab36f60b5d0`: 1 info
  - added the new enum value `PENDING_APPEAL` to the `query` request parameter `status`
- **2025-07-16** `ff8fb08e5138`: 2 info
  - added the new enum value `PENDING_EMAIL_VERIFICATION` to the `query` request parameter `status`
  - added the new enum value `REJECTED_AUTO` to the `query` request parameter `status`
- **2025-02-12** `ac1200a642be`: 2 info
  - added the new enum value `CMP` to the `query` request parameter `source`
  - added the new enum value `CSV` to the `query` request parameter `source`

[Operation history](https://skmtc.dev/osano/apis/osano-api-reference/changes/v1/subject-rights/requests/get.md)

---

[API](https://skmtc.dev/osano/apis/osano-api-reference.md) - [All operations](https://skmtc.dev/osano/apis/osano-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/osano-api-reference/revisions/ac31099cf83e?raw)