cURL

curl -X GET \
  -H "X-APP-ID: YOUR_APP_ID" \
  -H "X-APP-KEY: YOUR_APP_KEY" \
  "https://api.clickterm.com/public-client/v1/clickwrap-events?clickwrapTemplateId=987e6543-e21b-45d3-b321-426614174999&clickwrapEventStatus=ACCEPTED&limit=20"

const params = new URLSearchParams({
  clickwrapTemplateId: templateId,
  clickwrapEventStatus: "ACCEPTED",
  limit: "20",
});

const response = await fetch(
  `https://api.clickterm.com/public-client/v1/clickwrap-events?${params}`,
  {
    headers: {
      "X-APP-ID": process.env.CLICKTERM_APP_ID,
      "X-APP-KEY": process.env.CLICKTERM_APP_KEY,
    },
  }
);

const page = await response.json();

response = requests.get(
    "https://api.clickterm.com/public-client/v1/clickwrap-events",
    headers={
        "X-APP-ID": CLICKTERM_APP_ID,
        "X-APP-KEY": CLICKTERM_APP_KEY,
    },
    params={
        "clickwrapTemplateId": clickwrap_template_id,
        "clickwrapEventStatus": "ACCEPTED",
        "limit": 20,
    },
)
page = response.json()

HttpResponse<String> response = Unirest.get(
    "https://api.clickterm.com/public-client/v1/clickwrap-events")
  .header("X-APP-ID", "YOUR_APP_ID")
  .header("X-APP-KEY", "YOUR_APP_KEY")
  .queryString("clickwrapTemplateId", clickwrapTemplateId)
  .queryString("clickwrapEventStatus", "ACCEPTED")
  .queryString("limit", 20)
  .asString();

{
  "items": [
    {
      "clickwrapEventStatus": "ACCEPTED",
      "clickwrapEventId": "123e4567-e89b-12d3-a456-426614174000",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "clickwrapTemplateVersion": 3,
      "clickwrapTemplateVersionMinor": 1,
      "endUserId": "user-123",
      "templatePlaceholders": "{\"email\":\"[email protected]\"}",
      "technicalMetadata": "{\"userAgent\":\"Mozilla/5.0...\",\"ip\":\"203.0.113.42\"}",
      "presentedAt": "2026-03-23T14:25:00Z",
      "actionAt": "2026-03-23T14:30:00Z",
      "effectiveAt": "2026-03-23T14:00:00Z"
    },
    {
      "clickwrapEventStatus": "DECLINED",
      "clickwrapEventId": "223e4567-e89b-12d3-a456-426614174000",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "clickwrapTemplateVersion": 3,
      "clickwrapTemplateVersionMinor": 1,
      "endUserId": "user-456",
      "templatePlaceholders": null,
      "technicalMetadata": "{\"userAgent\":\"Mozilla/5.0...\",\"ip\":\"203.0.113.43\"}",
      "presentedAt": "2026-03-22T09:58:00Z",
      "actionAt": "2026-03-22T10:00:00Z",
      "effectiveAt": "2026-03-23T14:00:00Z"
    }
  ],
  "nextPageCursor": "eyJhY3Rpb25BdCI6IjIwMjYtMDMtMjJUMTA6MDA6MDBaIiwiZXZlbnRJZCI6IjIyM2U0NTY3LWU4OWItMTJkMy1hNDU2LTQyNjYxNDE3NDAwMCJ9"
}

List clickwrap events

Retrieve a paginated list of verified clickwrap events for the current tenant. Use this endpoint for audit workflows, compliance exports, and historical lookups across end users and templates.

Results are ordered newest first by actionAt. Filtering can be applied individually or in combination.

The nextPageCursor value is opaque. Clients must treat it as an uninterpreted value and pass it back exactly as returned.

Authenticated — requires X-APP-ID and X-APP-KEY headers.

GET

clickwrap-events

cURL

curl -X GET \
  -H "X-APP-ID: YOUR_APP_ID" \
  -H "X-APP-KEY: YOUR_APP_KEY" \
  "https://api.clickterm.com/public-client/v1/clickwrap-events?clickwrapTemplateId=987e6543-e21b-45d3-b321-426614174999&clickwrapEventStatus=ACCEPTED&limit=20"

const params = new URLSearchParams({
  clickwrapTemplateId: templateId,
  clickwrapEventStatus: "ACCEPTED",
  limit: "20",
});

const response = await fetch(
  `https://api.clickterm.com/public-client/v1/clickwrap-events?${params}`,
  {
    headers: {
      "X-APP-ID": process.env.CLICKTERM_APP_ID,
      "X-APP-KEY": process.env.CLICKTERM_APP_KEY,
    },
  }
);

const page = await response.json();

response = requests.get(
    "https://api.clickterm.com/public-client/v1/clickwrap-events",
    headers={
        "X-APP-ID": CLICKTERM_APP_ID,
        "X-APP-KEY": CLICKTERM_APP_KEY,
    },
    params={
        "clickwrapTemplateId": clickwrap_template_id,
        "clickwrapEventStatus": "ACCEPTED",
        "limit": 20,
    },
)
page = response.json()

HttpResponse<String> response = Unirest.get(
    "https://api.clickterm.com/public-client/v1/clickwrap-events")
  .header("X-APP-ID", "YOUR_APP_ID")
  .header("X-APP-KEY", "YOUR_APP_KEY")
  .queryString("clickwrapTemplateId", clickwrapTemplateId)
  .queryString("clickwrapEventStatus", "ACCEPTED")
  .queryString("limit", 20)
  .asString();

{
  "items": [
    {
      "clickwrapEventStatus": "ACCEPTED",
      "clickwrapEventId": "123e4567-e89b-12d3-a456-426614174000",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "clickwrapTemplateVersion": 3,
      "clickwrapTemplateVersionMinor": 1,
      "endUserId": "user-123",
      "templatePlaceholders": "{\"email\":\"[email protected]\"}",
      "technicalMetadata": "{\"userAgent\":\"Mozilla/5.0...\",\"ip\":\"203.0.113.42\"}",
      "presentedAt": "2026-03-23T14:25:00Z",
      "actionAt": "2026-03-23T14:30:00Z",
      "effectiveAt": "2026-03-23T14:00:00Z"
    },
    {
      "clickwrapEventStatus": "DECLINED",
      "clickwrapEventId": "223e4567-e89b-12d3-a456-426614174000",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "clickwrapTemplateVersion": 3,
      "clickwrapTemplateVersionMinor": 1,
      "endUserId": "user-456",
      "templatePlaceholders": null,
      "technicalMetadata": "{\"userAgent\":\"Mozilla/5.0...\",\"ip\":\"203.0.113.43\"}",
      "presentedAt": "2026-03-22T09:58:00Z",
      "actionAt": "2026-03-22T10:00:00Z",
      "effectiveAt": "2026-03-23T14:00:00Z"
    }
  ],
  "nextPageCursor": "eyJhY3Rpb25BdCI6IjIwMjYtMDMtMjJUMTA6MDA6MDBaIiwiZXZlbnRJZCI6IjIyM2U0NTY3LWU4OWItMTJkMy1hNDU2LTQyNjYxNDE3NDAwMCJ9"
}

Authorizations

X-APP-ID

string

header

required

Your application's App ID, sent as the X-APP-ID header. Must be accompanied by X-APP-KEY for authenticated endpoints.

X-APP-KEY

string

header

required

Your application's secret App Key (server-side only)

Query Parameters

clickwrapTemplateId

string<uuid>

Filter by Clickwrap Template ID

endUserId

string

Filter by end user identifier

clickwrapEventStatus

enum<string>

Filter by verified event status

Available options:

ACCEPTED,

DECLINED

from

string<date-time>

Inclusive lower bound for actionAt (UTC, ISO-8601)

string<date-time>

Inclusive upper bound for actionAt (UTC, ISO-8601). Must be after from.

limit

integer

default:20

Maximum number of results to return per page

Required range: 1 <= x <= 100

nextPageCursor

string

Opaque pagination cursor returned by the previous page

Response

Paginated list of clickwrap events

Cursor-paginated response containing verified clickwrap events

items

object[]

Events matching the supplied filters, ordered newest first by actionAt

Show child attributes

nextPageCursor

string | null

Opaque cursor for the next page, or null when no more results remain