> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingtree.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Click Listing API

> Fetch and embed click-based offer listings via API or iFrame using Pingtree’s dynamic rendering capabilities.

The Click Listing API and iFrame options allow you to dynamically retrieve or embed offer listings tied to specific transactions. Use these tools to extend Pingtree-powered listings into your external environments like custom funnels, landing pages, or partner sites.

## Click Listing API Endpoint

Use the Click Listing API to retrieve listings programmatically for a given transaction.

* **API URL Template:**

```
https://api.pingtree.com/click/list/cp379/[[transaction_id]]
```

Replace `[[transaction_id]]` with the actual transaction ID generated during the form submission.

* **Generate Token:**
  Click **Generate New Token** to create an authentication token. Use **Copy Token** to copy it for use in the request.

* **Header Format:**

```json theme={null}
{
  "Authorization": "Bearer <your_token>"
}
```

## Use Case:

Send a `transaction_id` to retrieve personalized offer blocks for that lead. The API response returns listing details such as:

* Offer title
* CTA highlights
* Redirection URLs
* Mapped lead fields (if configured)

## Response Codes:

Reference status codes are available in the interface to help interpret the results.

## Click Listing iFrame

Use the iFrame embed option to display listings visually within your own site or landing page.

## Whitelist Domain (Optional):

Toggle Enable Whitelist to restrict iframe visibility to a specific domain.

* Enter only the domain name (e.g., `yourdomain.com`) without `http://` or `https://`.
* Click Submit to save.

## iFrame Embed Code:

A ready-to-use `<iframe>` code is auto-generated with the embedded `transaction_id` in the URL. This renders a fully styled click listing UI tailored to the associated lead data.

## Note:

* The iframe must be placed on a page that includes a valid `transaction_id` generated by Pingtree. If this ID is missing or invalid, no listings will appear.