Publisher Posting Instructions

Posting Methods

You can post leads into the Realtime Leads API using either of the following methods:

1

Full Posting URL

Query parameters appended to a GET or POST URL

2

JSON POST Request

Structured JSON body to the /v1/leads endpoint

For most publishers, the full posting URL is the easiest option.

Primary Posting Endpoint

POST/GET https://rtl.quoteotter.com/capture.php

Publisher Identification

No authentication key is required. Instead, include your assigned publisher ID on every request:

publisherId= YOUR_PUBLISHER_ID

You may also use Aff_ID or Affiliate_ID as the publisher identifier parameter name.

Full URL Example

Below is a complete example URL with all standard fields populated. Remember to URL-encode all query-string values.

Full Posting URL

https://rtl.quoteotter.com/capture.php
?publisherId=pub-001
&Lead_ID=pub-001
&Jornaya_ID=jour-123
&TrustedForm_URL=https%3A%2F%2Fcert.trustedform.com%2Fexample
&IP_Address=203.0.113.10
&First_Name=Jane
&Last_Name=Doe
&Address=1+Main+St
&City=Miami
&State=FL
&Zip=33101
&Email=jane%40example.com
&Phone=3055550101
&Age=42
&Coverage_Amount=250000
&TCPA_Consent=true

Important

Always URL-encode special characters in query-string values (spaces, @, /, etc.).

Query String Aliases

If your platform uses different field names, these aliases are also accepted:

Alias	Maps To
firstname	First_Name
lastname	Last_Name
email	Email
phone1	Phone
address1	Address
LeadIP	IP_Address
PostURL	Lead_Source

JSON POST Option

For platforms that support structured payloads, use the JSON endpoint:

POST https://rtl.quoteotter.com/v1/leads?mode=async

Headers

Content-Type: application/json

Request Body

{
  "publisherId": "pub-001",
  "lead": {
    "Lead_ID": "pub-001",
    "Jornaya_ID": "jour-123",
    "TrustedForm_URL": "https://cert.trustedform.com/example",
    "IP_Address": "203.0.113.10",
    "First_Name": "Jane",
    "Last_Name": "Doe",
    "Address": "1 Main St",
    "City": "Miami",
    "State": "FL",
    "Zip": "33101",
    "Email": "jane@example.com",
    "Phone": "3055550101",
    "Age": 42,
    "Coverage_Amount": 250000,
    "TCPA_Consent": true,
    "Opt_In_Date": "2026-03-12",
    "Opt_In_Time": "14:22:11"
  }
}

Response Format

For a successful async post, the API returns a JSON response:

{
  "leadId": "25ad176a-31ee-4629-8d1f-69c21bc1a1dc",
  "traceId": "bb8c1864-60d7-465d-a405-03df1eea876c",
  "affiliateId": "aff-001",
  "status": "accepted",
  "responseMode": "async",
  "poll": "/v1/leads/25ad176a-...1a1dc"
}

Use the poll URL to check lead status asynchronously.

Accepted Lead Fields

The following standard fields are accepted. Additional custom fields beyond this list can also be sent and will be stored with the lead payload.

Field	Description	Field	Description
Lead_ID	Unique lead identifier	Income	Annual income
Jornaya_ID	Jornaya tracking ID	Gender	Gender
TrustedForm_URL	TrustedForm certificate URL	Marital_Status	Marital status
IP_Address	Consumer's IP address	Home_Owner	Yes / No
First_Name	Consumer first name	Smoker_Status	Yes / No
Last_Name	Consumer last name	Coverage_Amount	Requested coverage amount
Address	Street address	Best_Time_To_Call	Morning / Afternoon / Evening
City	City	Lead_Source	Originating website or source
State	Two-letter state code	User_Agent	Browser user agent string
Zip	ZIP / postal code	Device_Type	Desktop / Mobile / Tablet
Email	Email address	TCPA_Consent	true / false
Phone	Phone number	Opt_In_Date	YYYY-MM-DD
Age	Consumer age	Opt_In_Time	HH:MM:SS

Additional fields beyond this list will also be accepted and stored as part of the lead payload.

Important Notes

URL posting to capture.php supports both GET and form-style POST.
JSON posting to /v1/leads is the cleaner format when your platform supports it.
Include publisherId, Aff_ID, or Affiliate_ID so we can identify the publisher.
Always URL-encode all query-string values when using the full posting URL method.
If your platform can only send a full URL, use capture.php.

Publisher Quick-Start Template

Copy and send this summary to your publishing partners:

Please post leads to:
https://rtl.quoteotter.com/capture.php

Include your publisher ID as:
publisherId=YOUR_PUBLISHER_ID

Standard accepted fields:
Lead_ID, Jornaya_ID, TrustedForm_URL, IP_Address,
First_Name, Last_Name, Address, City, State, Zip,
Email, Phone, Age, Income, Gender, Marital_Status,
Home_Owner, Smoker_Status, Coverage_Amount,
Best_Time_To_Call, Lead_Source, User_Agent,
Device_Type, TCPA_Consent, Opt_In_Date, Opt_In_Time

Additional custom fields can also be sent if needed.