Follow

Claims

When a TrustedForm certificate is received with a lead, you should make a claim on the certificate. Making a claim imparts the following benefits:

  • Certificate authenticity is verified
  • Certificate details can be extracted for storage in your system
  • Certificate details including the snapshot and page image are stored in your account for later reference
  • Certificate lead fingerprints can be checked using the lead data you received
  • Tracking information such as the vendor and a reference code can be provided to TrustedForm for later reference

Fields

In addition to providing the cert data, the following fields are available on a claim:

  • 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 "How do you share a TrustedForm certificate?" for more information.
  • created_at — The time the claim was created in UTC, ISO8601 format
  • expires_at — The time the claim 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 object for this claim
    • 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 (the time the certificate was created)
    • event_duration — The time in milliseconds the user took to complete the form. Matches Time On Page on the certificate page.
    • 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
    • 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
    • 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 and account, including this claim
      • 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.

Creating a claim

When a claim is made against a cert, a new claim record is stored in TrustedForm.

Retrieving a claim

After you have created a claim, you can retrieve it using an HTTP GET call. Specify the Accept header in order to get JSON.

NOTE: This query will only give you claims for the last three days

Listing claims

NOTE: This query will only give you claims for the last three days.

Claims are listed in chronological order. The following parameters can be used to filter the list.

  • limit — max number of claims to return (must be less than 100)
  • before_id — return claims older than that referenced by this ID
  • page_id — return claims only for this page
  • desc=true — return claims in reverse chronological order

Updating claims

Claims cannot be updated.

Deleting claims

Claims are automatically deleted by TrustedForm based on the retention threshold setting on your account. Claims cannot be individually deleted.

You can change the claim retention threshold by logging into the TrustedForm application with your browser, or, by using the Account API to change the claim_dtl as shown below.

Setting a reliable timeout for pulling snapshots

Most users who pull the snapshot via the API immediately after claiming the TrustedForm certificate won't need to set a timeout to pull the snapshot successfully. However, if you are experiencing a 404 status code when trying to pull the snapshot immediately after claiming the certificate - setting a 1 minute timeout before making another request to the API for the recently claimed certificate will allow for a successful request and avoid the 404 status code. 

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

Comments

You must be logged in to comment.