# Consent records, newest first

Source: https://docs.usetone.ai/reference/compliance/consent.list

> Consent is purpose-scoped, so a number can appear several times — once per purpose.

`GET /v1/consent`
Consent is purpose-scoped, so a number can appear several times — once per purpose. `active=true` filters to the records that would satisfy the gate right now.

Requires the `read` scope.

## Parameters

| Name | In | | Meaning |
|---|---|---|---|
| `limit` | query | optional | How many records to return. 1-100. |
| `cursor` | query | optional | Opaque page cursor from the previous response. |
| `e164` | query | optional | Only records for this number. |
| `purpose` | query | optional | Only records covering this purpose. Open set — handle an unrecognised value rather than throwing. Today: `promotional`, `service`, `transactional`, `collections`. |
| `active` | query | optional | Only records that would satisfy the gate right now — neither revoked nor expired. |

## Response



### Example response

```json
{
  "data": [
    {
      "active": true,
      "capturedAt": "2026-08-20T11:02:00Z",
      "createdAt": "2026-08-25T09:14:22Z",
      "e164": "+919876543210",
      "evidenceRef": "form-sub-88213",
      "expiresAt": "2026-11-23T09:14:22Z",
      "id": "8814",
      "kind": "explicit",
      "purpose": "promotional",
      "revokedAt": null,
      "revokedReason": null,
      "scope": "Order updates and delivery reminders.",
      "source": "api"
    }
  ]
}
```