Generator endpoints

Associate & Verify

Combines the Associate and Verify APIs: Associates a specific TrueCall ID and dialed number combination with a customer’s phone number and runs a full verification on the TrueCall ID, validating all settings, including matching the consumer’s phone number to the TrueCall ID.

This stores the TrueCall ID to your account and allows all data to be accessed with Get Sessions and List Session.

Typically used in Dual Identity campaigns (where the Generator is also the End User).

GET

associate-verify

curl --request GET \
  --url https://api.truecall.com/associate-verify

{
  "tc_req_id": "bnqtkot35h9bxgqi8ymva70x1easzqb7l7lt",
  "tc_status": "success",
  "tc_insights": {
    "source_url": "<string>",
    "ip": [
      "<string>"
    ],
    "city": "<string>",
    "country": "<string>",
    "country_iso": "<string>",
    "timezone": 123,
    "platform": "<string>",
    "user_agent": "<string>",
    "browser_name": "<string>",
    "created_at": 123
  }
}

Query Parameters

api_key

string

required

Campaign's API key

tc_id

string

required

TrueCall session ID

dialed_number

string

required

Number dialed by consumer

consumer_phone

string

required

Consumer's phone number

insights

string

Session data to include in the response.

Available options are:

Those can be combined to get specifically what's needed:

insights=source_url,city,country,created_at_iso

Response

200 - application/json

Associate and verify response

tc_req_id

string

Example:

"bnqtkot35h9bxgqi8ymva70x1easzqb7l7lt"

tc_status

enum<string>

Available options:

success

Example:

"success"

tc_insights

object | null

Associate Check

curl --request GET \
  --url https://api.truecall.com/associate-verify

{
  "tc_req_id": "bnqtkot35h9bxgqi8ymva70x1easzqb7l7lt",
  "tc_status": "success",
  "tc_insights": {
    "source_url": "<string>",
    "ip": [
      "<string>"
    ],
    "city": "<string>",
    "country": "<string>",
    "country_iso": "<string>",
    "timezone": 123,
    "platform": "<string>",
    "user_agent": "<string>",
    "browser_name": "<string>",
    "created_at": 123
  }
}

General

Endpoints

Generator endpoints

Buyer endpoints

Associate & Verify

Query Parameters

Response