API referenceCompliance

Get a person's consent

GET
/v2/consents

Every consent state on record for the contact holding this number (current first), and which of its numbers are on the do-not-contact list.

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).

Query Parameters

phone*string

The person's number, E.164.

Header Parameters

Gauge-Version?string

A dated version. Default 2026-10-21.

Response Body

The consent history.

application/json
  1. response
contactId*string
Formatuuid
onDncList*array<string>

The contact's phone numbers that are on the do-not-contact list.

entries*array<>
Example Request
curl -X GET 'https://app.gauge.chat/backend/v2/consents?phone=string'
Example Response
{  "contactId": "b5ec5d98-4bee-4da1-ad24-dde86346cb1d",  "onDncList": [    "string"  ],  "entries": [    {      "channel": "string",      "purpose": "marketing",      "state": "opted_in",      "source": "string",      "at": "string",      "current": true    }  ]}