Certificate fields explained

When a visitor lands on a page hosting the TrustedForm JavaScript, a new certificate record is created in TrustedForm. 

The following fields are available for every certificate record issued by TrustedForm

  • token — Uniquely identifies this certificate
  • ip — The consumer's public IP address
  • location — The URL of the page hosting our JavaScript. Query strings hidden for privacy reasons
  • parent_location — If the page was framed, the parent frame's URL
  • framed — true or false, depending on whether the form is hosted on a framed page
  • browser — A human-friendly version of user_agent
  • operating_system — A human-friendly version of the user's operating system
  • user_agent — The consumer's browser user-agent
  • snapshot_url — The URL of our snapshot of the offer page as seen by the consumer at the time of signup
  • created_at — The time the consumer loaded the vendor's form in UTC, ISO8601 format
  • event_duration — The time in milliseconds the user took to complete the form
  • expires_at — The date and time the certificate will no longer be available for further claims
  • share_url —A shareable URL that allows customers to send TrustedForm certificates to third parties on an as-needed basis
  • geo — A hash of geolocation data based on the IP address
    • lat — Latitude
    • lon — Longitude
    • city — City name
    • state — State or Province name
    • postal_code — Mailing address postal code
    • country_code — Country code
    • time_zone — Time zone name per the Olson Database
  • claims — An array of claim records for this certificate - see Claim documentation for additional details on the data available in this field

Retrieving a certificate

A certificate may only be retrieved after it has been claimed. Attempting to retrieve an unclaimed certificate will result in an HTTP

Was this article helpful?
7 out of 8 found this helpful
Have more questions? Submit a request


You must be logged in to comment.