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 information about certificate claiming):
    • id — The claim identifier
    • age  — The age of the claim (The time in seconds since the user's last event on the page, minus the time the claim was made)
    • page_id — The unique identifier for the page where the cert was generated
    • warnings — An array of string warnings revealing any potential problems with the cert or claim
    • reference — The reference provided when the certificate was claimed
    • vendor — The vendor name provided when the certificate was claimed
    • fingerprints — The lead fingerprints provided when the certificate was claimed
      • matching — those that matched a fingerprint collected at the time of consumer signup
      • non_matching — those that did not match any fingerprint collected at the time of consumer signup
    • share_url - Shareable url to view the claim. See the knowledge base article "How do you share a TrustedForm certificate?"  
    • created_at — The time the claim was created in UTC, ISO8601 format
    • expires_at — The time the will expire your account in UTC, ISO8601 format
    • masked — A boolean indicating whether the certificate is masked
    • masked_cert_url — A URL with the masked certificate of the claim
    • cert — The certificate record for this claim - see the Certificate documentation for additional details on the data available in this field
    • scans — A hash of the snapshot scans performed
      • found — those that were found on the page snapshot
      • not_found — those that were not found on the page snapshot
    • warnings — An array of strings indicating possible issues with the certificate. At the moment, only used for Page Scanning.

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 404 response.

The example below contians both the certificate fields and claim data.

Was this article helpful?
11 out of 14 found this helpful
Have more questions? Submit a request


You must be logged in to comment.