API

GET /api/v1/consents

Retrieve the consent status for a user or application purpose and review whether it is currently active.

Check consent

Use this endpoint to validate whether consent exists and whether it is still valid for a given purpose or subject.

GET

Query parameters

ParameterTypeDescription
subjectIdstringUnique identifier of the data subject.
purposestringThe purpose or processing use case to check.
applicationIdstringOptional application identifier.
curl "https://apis.digitalanumati.com/api/v1/consents?subjectId=user_12345&purpose=appointment-communication" \
  -H "Authorization: Bearer <token>"

Response

{
  "status": "active",
  "purpose": "appointment-communication",
  "grantedAt": "2026-09-28T10:00:00Z",
  "validTo": "2027-09-28T10:00:00Z",
  "source": "web",
  "consentId": "c_01J7NM6QX9"
}

Status logic

If the consent is revoked, expired, or erased, the API should return a non-active status and a clear state code.