Consent link history

GET /api/outside-app/consent-link/history

Use this endpoint to retrieve a full list of consent link requests your organization has created, ordered from most recent to oldest. Each entry includes the current state of the request — whether consent has been completed, the link has been regenerated, and how many regenerations have occurred. Phone numbers are masked in all responses to minimize personal data exposure.

Authentication

Query parameters

This endpoint accepts no query parameters. All requests return the full history for the authenticated organization.

Response

200 OK — an array of consent link request objects.

Field	Type	Description
`request_id`	string	Stable identifier for this consent request
`event_id`	string	Identifier of the most recently issued link instance
`phone`	string	The data principal’s phone number, masked. Only the last four digits are visible (for example, `+*********1234`).
`expires_at`	string	ISO 8601 timestamp of when the current link expires
`is_completed`	boolean	`true` if the data principal has submitted their consent
`is_regenerated`	boolean	`true` if this link instance has been superseded by a regeneration
`regeneration_count`	integer	Total number of times this request has been regenerated
`created_at`	string	ISO 8601 timestamp of when this request was first created
`collection_point_name`	string	Display name of the associated collection point
`collection_point_display_id`	string	Human-readable identifier of the collection point
`consent_link`	string	The magic link URL for this request

Errors

Status	Description
`400`	Tenant context could not be resolved from the provided token
`500`	Unexpected internal error

Example

curl --request GET \
  --url https://api.truConsent.io/api/outside-app/consent-link/history \
  --header 'Authorization: Bearer <token>'

[
  {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "event_id": "11223344-5566-7788-99aa-bbccddeeff00",
    "phone": "+*********4311",
    "expires_at": "2026-04-22T10:00:00+00:00",
    "is_completed": false,
    "is_regenerated": true,
    "regeneration_count": 1,
    "created_at": "2026-04-21T08:30:00+00:00",
    "collection_point_name": "Onboarding Consent v2",
    "collection_point_display_id": "cp_onboarding_v2",
    "consent_link": "https://collect.truConsent.io/acme/cp_onboarding_v2/11223344-5566-7788-99aa-bbccddeeff00"
  },
  {
    "request_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "event_id": "aabbccdd-eeff-0011-2233-445566778899",
    "phone": "+*********7890",
    "expires_at": "2026-04-20T15:00:00+00:00",
    "is_completed": true,
    "is_regenerated": false,
    "regeneration_count": 0,
    "created_at": "2026-04-19T15:00:00+00:00",
    "collection_point_name": "Marketing Preferences",
    "collection_point_display_id": "cp_marketing_prefs",
    "consent_link": "https://collect.truConsent.io/acme/cp_marketing_prefs/aabbccdd-eeff-0011-2233-445566778899"
  }
]