> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Grievances

> List the developer's DPDP grievances, newest first, filtered by status or data principal.

## Endpoint

```
GET /v1/dpdp/grievances
```

## Authentication

Requires a developer API key in the `Authorization` header.

## Query Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `status` | `string` | No | `submitted`, `in_review`, `resolved` or `rejected` |
| `dataPrincipalId` | `string` | No | Only this data principal's grievances |
| `limit` | `integer` | No | Page size, 1 to 200 (default 50) |
| `cursor` | `string` | No | The `nextCursor` of the previous page |

## Example Request

```bash theme={null}
curl "https://api.grantex.dev/v1/dpdp/grievances?status=submitted" \
  -H "Authorization: Bearer gx_..."
```

## Response -- 200 OK

```json theme={null}
{
  "grievances": [
    {
      "grievanceId": "grv_01HXYZ...",
      "dataPrincipalId": "user_abc123",
      "recordId": null,
      "type": "consent-violation",
      "status": "submitted",
      "referenceNumber": "GRV-2026-01J9Z6ZC4Q8F2V1K3M5N7P9R0S",
      "expectedResolutionBy": "2026-04-12T14:00:00.000Z",
      "responsePeriodDays": 7,
      "resolvedAt": null,
      "resolution": null,
      "createdAt": "2026-04-05T14:00:00.000Z",
      "updatedAt": null
    }
  ],
  "nextCursor": null
}
```

List entries leave out `description` and `evidence`; read them with
[Get Grievance](/api-reference/dpdp/get-grievance).

## Error Responses

| Status | Code | Description |
| - | - | - |
| 400 | `BAD_REQUEST` | Unknown `status`, `limit` outside 1 to 200, or an invalid `cursor` |
| 401 | `UNAUTHORIZED` | Invalid or missing API key |

## Ownership

Grantex is owned by Orchestrum Technologies LLP. Inventor and owner: Sanjeev Kumar. Ownership contact: [sanjeev@orchestrum.in](mailto:sanjeev@orchestrum.in) or [mishra.sanjeev@gmail.com](mailto:mishra.sanjeev@gmail.com).