# List Quorum Requests

Your administrators' covered actions — held for another administrator, or only recorded — newest first.

## Overview

- `state`, `action` and `requestedBy` narrow it; up to `limit` (1–100, default 50) in `requests`, and `nextCursor` to send as `cursor` for the next page (`null` on the last). The decisions are in [Get a Request](https://docs.aureahub.com/docs/quorum-request-get.md).
- Only your tenant's requests. For `owner`, `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` and `security_auditor`. [Your Tenant's Quorum](https://docs.aureahub.com/docs/guide-tenant-quorum.md).

## Endpoint

### `GET /v1/quorum/requests`

Authentication: bearer token required.

Your tenant's quorum requests, newest first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | no | `observed`, `awaiting_quorum`, `approved`, `rejected`, `expired`, `executed`, `failed` or `cancelled` |
| `action` | string | no | An action key, e.g. `credentials.api_secret.rotate` ([Covered Actions](https://docs.aureahub.com/docs/guide-tenant-quorum.md)) |
| `requestedBy` | string (uuid) | no | The administrator who asked |
| `cursor` | string | no | The previous page's `nextCursor` |
| `limit` | integer | no | 1–100, default 50 |

**Responses**

`200` OK

```json
{
  "requests": [
    {
      "id": "4e2b9c17-8a3d-4f60-b5e1-7c9d0a2f6b38",
      "action": "credentials.api_secret.rotate",
      "group": "credentials_and_secrets",
      "state": "awaiting_quorum",
      "mode": "enforce",
      "target": {
        "tenantId": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
        "userId": null,
        "resourceType": null,
        "resourceId": null
      },
      "details": {},
      "requestedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
      "requestedAt": "2026-10-09T09:00:00.000Z",
      "route": "POST /v1/admin/tenants/:id/rotate-secret",
      "requestId": "9c4e7a12-3b6d-4f80-a1c5-2e8b0d7f6a93",
      "requiredApprovals": 1,
      "approvals": 0,
      "expiresAt": "2026-10-10T09:00:00.000Z",
      "decidedAt": null,
      "executedAt": null,
      "resultStatus": null,
      "secretAnswer": true,
      "resultAvailable": false,
      "resultReadAt": null,
      "error": null
    }
  ],
  "nextCursor": null
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/quorum/requests?state=awaiting_quorum" \
  -H "Authorization: Bearer $ADMIN_TOKEN"
```

---

Web version: https://docs.aureahub.com/#quorum-requests-list