Fetch Form Submission API

GET

api

lead

fetch-response

{campaign-id}

cURL

curl --request GET \
  --url https://api.pingtree.com/api/lead/fetch-response/{campaign-id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.pingtree.com/api/lead/fetch-response/{campaign-id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.pingtree.com/api/lead/fetch-response/{campaign-id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pingtree.com/api/lead/fetch-response/{campaign-id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

Overview

The Fetch Form Submission API retrieves the stored response data for a previously submitted lead. Use it to look up the distribution outcome, buyer response, deduplication result, or redirect URL associated with a specific transaction_id. This is useful for debugging integrations, auditing lead outcomes, and building confirmation pages that display post-submission results.

Endpoint

GET /api/lead/fetch/:sourceID

Replace :sourceID with the source unique ID. The transaction_id is passed as a query parameter to identify the specific lead.

Authentication

Include your API token in the Authorization header:

Authorization: Bearer <your-api-token>

Request Parameters

Path Parameters

Parameter	Type	Required	Description
`sourceID`	string	Yes	The unique ID of the campaign source

Query Parameters

Parameter	Type	Required	Description
`transaction_id`	string	Yes	The transaction ID of the lead submission to retrieve

Example Request

curl -G "https://api.pingtree.com/api/lead/fetch/src_abc123" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --data-urlencode "transaction_id=txn_7f3a2b1c-4d56-78ef-9012-abcdef123456"

Example Responses

Success — Lead Response Found

{
  "status": 200,
  "message": "Lead response fetched successfully",
  "data": {
    "transaction_id": "txn_7f3a2b1c-4d56-78ef-9012-abcdef123456",
    "leadStatus": "accepted",
    "redirect_url": "https://thank-you.example.com?tid=txn_7f3a2b1c",
    "isDeDupe": false,
    "cid": "cmp_9z8y7x6w",
    "pid": "src_abc123",
    "createdAt": "2025-08-14T10:32:00.000Z"
  }
}

Success — Duplicate Lead

{
  "status": 200,
  "message": "Lead response fetched successfully",
  "data": {
    "transaction_id": "txn_7f3a2b1c-4d56-78ef-9012-abcdef123456",
    "leadStatus": "unsold",
    "isDeDupe": true,
    "cid": "cmp_9z8y7x6w",
    "pid": "src_abc123",
    "createdAt": "2025-08-14T10:35:00.000Z"
  }
}

Error — Lead Not Found

{
  "status": 400,
  "message": "No lead found for the provided transaction_id",
  "data": {}
}

Error — Unauthorized

{
  "status": 401,
  "message": "Unauthorized"
}

Status Codes

HTTP Code	Description
200	Lead response retrieved successfully
400	Invalid or missing `transaction_id`, or lead not found
401	Invalid or missing API token
500	Internal server error

Tips

Immediate availability: Response data is available as soon as the lead submission completes. In most cases, you can fetch it within a few milliseconds of the original POST.
Debugging submissions: If a landing page integration is not behaving as expected, use this endpoint to confirm what the platform recorded and returned during distribution.
Redirect URL delivery: If your form does not capture the redirect_url from the submission response, you can re-fetch it here and redirect the consumer server-side.
Deduplication flag: The isDeDupe field lets you determine whether the consumer had previously submitted through this campaign.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaign-id

string

required

Your campaign ID

Query Parameters

transaction_id

string

required

Your lead transaction ID

Response

Lead successfully matched

status

string

Status code of API response

type

string

Type of API response which can be success or error

message

string

Message of API response

Lead List APIThe Campaign Lead List API retrieves a comprehensive list of leads linked to a particular campaign. This enables easy access to lead data for analysis, reporting, or follow-up tasks, ensuring campaign data is organized and accessible.

cURL

curl --request GET \
  --url https://api.pingtree.com/api/lead/fetch-response/{campaign-id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.pingtree.com/api/lead/fetch-response/{campaign-id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pingtree.com/api/lead/fetch-response/{campaign-id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.pingtree.com/api/lead/fetch-response/{campaign-id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pingtree.com/api/lead/fetch-response/{campaign-id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

{
  "status": "<string>",
  "type": "<string>",
  "message": "<string>"
}

API Documentation

Offer Campaign APIs

Database Source

Global Event Postback API

Overview

Endpoint

Authentication

Request Parameters

Path Parameters

Query Parameters

Example Request

Example Responses

Success — Lead Response Found

Success — Duplicate Lead

Error — Lead Not Found

Error — Unauthorized

Status Codes

Tips

Authorizations

Path Parameters

Query Parameters

Response

​Overview

​Endpoint

​Authentication

​Request Parameters

​Path Parameters

​Query Parameters

​Example Request

​Example Responses

​Success — Lead Response Found

​Success — Duplicate Lead

​Error — Lead Not Found

​Error — Unauthorized

​Status Codes

​Tips

Authorizations

Path Parameters

Query Parameters

Response

Overview

Endpoint

Authentication

Request Parameters

Path Parameters

Query Parameters

Example Request

Example Responses

Success — Lead Response Found

Success — Duplicate Lead

Error — Lead Not Found

Error — Unauthorized

Status Codes

Tips