Ping

Retrieve Ping Data

Retrieve ping data directly from a Certificate. When a lead vendor only provides a TrustedForm Certificate URL, Ping data can be retrieved directly without a Ping URL. Simply append /ping to the Certificate URL and perform an authenticated GET. A certificate's Ping data can be accessed two ways:

  • Querying a modified TrustedForm Certificate URL
  • Querying a vendor-provided TrustedForm Ping URL
SecurityAPI Key
Request
path Parameters
cert_id
required
string

Certificate ID

Responses
200

Ping Data

400

Malformed Certificate URL

401

Unauthorized

404

Certificate Not Found

get/{cert_id}/ping
Request samples 
API_KEY="f3bff7c5140a10ab5ff2e628f433f0bb51d255d1a"
CERT_ID="1f1b96c9150d8050e858c043d543bb4eadae0e6f"
curl --user "API:$API_KEY" \
     --request GET \
     https://cert.trustedform.com/$CERT_ID/ping
Response samples
application/json
{
  • "age": 0,
  • "client": {
    • "ip": "string",
    • "user_agent": "string",
    • "dimensions": {
      • "screen": {
        • "width": 0,
        • "height": 0
        },
      • "window": {
        • "width": 0,
        • "height": 0
        }
      },
    • "geo": {
      • "city": "string",
      • "country": "string",
      • "postal_code": "string",
      • "subdivisions": [
        • "string"
        ]
      }
    },
  • "created_at": "2019-08-24T14:15:22Z",
  • "location": {
    • "framed": true,
    • "parent_url": "string",
    • "url": "string"
    },
  • "time_on_page": 0,
  • "type": "string"
}