# Consents · Customer API

> Customer API reference for consents: GET /consents, PATCH /consents.

> Markdown version of https://kanorio.com/en/developers/customer-api/consents. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp

Base URL: `https://{site}/api/v1/customer` · [Errors](https://kanorio.com/en/developers/basics/errors) · [Pagination](https://kanorio.com/en/developers/basics/pagination)

### Marketing preferences per channel

`GET /consents`

- Stability: beta

Channels the customer can be reached on (email, SMS, LINE, WhatsApp) with the current marketing status. Bounced or complained channels are locked.

**Response** (200)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consents` | object[] | yes | — |
| `consents[].channel` | "EMAIL" \| "SMS" \| "LINE" \| "WHATSAPP" | yes | — |
| `consents[].status` | "NEVER_SUBSCRIBED" \| "PENDING" \| "SUBSCRIBED" \| "UNSUBSCRIBED" \| "BOUNCED" \| "COMPLAINED" | yes | — |
| `consents[].changeable` | boolean | yes | False when the channel bounced or was reported as spam. |
| `consents[].updatedAt` | string \| null | yes | — |

```bash
curl -X GET "https://{site}/api/v1/customer/consents" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"
```

### Subscribe or unsubscribe one channel

`PATCH /consents`

- Stability: beta

Recorded as a first-party consent change (source LOGIN) with IP and user agent as evidence; a previously unsubscribed customer can re-subscribe here.

**Request body**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | "EMAIL" \| "SMS" \| "LINE" \| "WHATSAPP" | yes | — |
| `subscribed` | boolean | yes | — |

**Response** (200)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consent` | object | yes | — |
| `consent.channel` | "EMAIL" \| "SMS" \| "LINE" \| "WHATSAPP" | yes | — |
| `consent.status` | "NEVER_SUBSCRIBED" \| "PENDING" \| "SUBSCRIBED" \| "UNSUBSCRIBED" \| "BOUNCED" \| "COMPLAINED" | yes | — |
| `consent.changeable` | boolean | yes | False when the channel bounced or was reported as spam. |
| `consent.updatedAt` | string \| null | yes | — |

**Errors**

| Code | Status | When |
| --- | --- | --- |
| `VALIDATION` | 400 | — |
| `CONSENT_LOCKED` | 409 | — |

```bash
curl -X PATCH "https://{site}/api/v1/customer/consents" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```
