---
title: "Retrieve Ping Data"
method: GET
path: "/{cert_id}/ping"
tags: ["Ping"]
deprecated: true
---

# Retrieve Ping Data

`GET /{cert_id}/ping`

> **Deprecated.**

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

## Path parameters

- `cert_id` string, required

## Response `200`

Ping Data

- Ping
  - `age` integer — Lead Age, in milliseconds. (The time elapsed between the final recorded interaction event and the call to this API)
  - `client` object — Information about the user's device and browser.
    - `ip` string — The device's IP address.
    - `user_agent` string — The browser's `User-Agent` header.
    - `dimensions` object — The device and browser visual display sizes.
      - `screen` Dimension — In pixels.
        - `width` integer
        - `height` integer
      - `window` Dimension — In pixels.
        - `width` integer
        - `height` integer
    - `geo` object — Geographic information derived from the device's IP address.
      - `city` string — The device's city.
      - `country` string — The device's country.
      - `postal_code` string — The device's postal code.
      - `subdivisions` string[] — The device location's political subdivisions. States, provinces, prefectures, etc...
  - `created_at` string, date-time — When the certificate was issued, in [ISO8601 format](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14).
  - `location` object — Information about the page's location.
    - `framed` boolean — Indicates if the page that generaed the Certificate was in a frame.
    - `parent_url` string, nullable — If the page was in a frame, the parent frame's URL. If the parent frame is the `window`, it will be the `window`'s URL.
    - `url` string — The URL of the page where the Certificate was generated.
  - `time_on_page` integer — The amount of time the user spent interacting with the page, in milliseconds. (The time elapsed between `created_at` and the final recorded interaction event)
  - `type` string — The type of certificate associated with this response. Possible values are limited to "standard", "masked", or "facebook".

## Other responses

- `400` — Malformed Certificate URL
- `401` — Unauthorized
- `404` — Certificate not found

---

[API](https://skmtc.net/activeprospect/apis/trustedform-claiming-api.md) · [All operations](https://skmtc.net/activeprospect/apis/trustedform-claiming-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/activeprospect/trustedform-claiming-api/versions/d6b59eb89306/schema)