---
title: "Get consent for a contact"
method: GET
path: "/{contact_type}/consent"
tags: ["consents"]
---

# Get consent for a contact

`GET /{contact_type}/consent`

## Request

- Base URL: `https://api.fullpath.com/consent-management`
- URL: `https://api.fullpath.com/consent-management/{contact_type}/consent`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/docs/:contact_type/consent/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current consent status for a single contact at the target dealer.

When no consent record exists, the response is `200` with `opt_in` and
`consent_timestamp` set to `null` (not `404`).

Requires `client_key` to identify the target dealer.

## Path parameters

- `contact_type` 'email' | 'phone_sms' | 'phone_call', required

## Query parameters

- `contact_value` string, required
- `client_key` string, required

## Response `200`

Consent status for the contact (including when no record exists).

- CmConsentResponse
  - `contact_value` string, required: Normalized contact value used for the lookup.
  - `opt_in` boolean, nullable, required: `true` if opted in, `false` if opted out, `null` when no consent record exists for this contact.
  - `consent_timestamp` string, date-time, nullable, required: ISO 8601 timestamp of the consent event. `null` when no consent record exists.

## Other responses

- `400`: Request failed business-rule validation outside Laravel form validation.
- `401`: Missing, invalid, or expired Bearer token.
- `422`: Laravel validation failure (422 Unprocessable Entity).
- `429`: Rate limit exceeded (100 requests per minute per API key).

## Changes

- **2026-11-06** `4b73e1835a7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/changes/:contact_type/consent/get.md)

---

[API](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0.md) - [All operations](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/revisions/4b73e1835a7e?raw)