View Categories

Does Trestle Have a Sandbox Environment To Test Integrations?

47 min read

Yes, we have a sandbox environment to test some of our APIs. Please see the details below. 

Why:  #

A sandbox environment allows developers to test various scenarios and ensure the API integration is working as expected within their systems and application workflows without needing to use live data. 

APIs Supported:  #

  1. Real Contact 1.1 API
  2. Real Contact 2.0 API
  3. Phone Validation 3.0 API
  4. Reverse Phone 3.2 API 
  5. Caller Identification 3.1 API
  6. Decision Signals 1.0 API
  7. Smart CNAM 3.1 API

How does it work? #

The developer will have to add an additional parameter, is_sandbox = true, along with the API. This will activate specific responses for specific input data (list below). A sample sandbox request and its response is below.

Request: #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?address.state_code=WA&address.postal_code=98101&phone=300-555-0103&name=%20Jon%20Snow%20&address.street_line_1=%20103%20Main%20Doors%20&address.city=%20Kings%20Landing&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'

Response: #

{
   "phone.is_valid": true,
   "phone.activity_score": 100,
   "phone.linetype": "Mobile",
   "phone.name_match": true,
   "phone.contact_grade": "A",
   "email.is_valid": true,
   "email.name_match": true,
   "email.contact_grade": "A",
   "address.is_valid": true,
   "address.name_match": true,
   "errors": null,
   "warnings": []
}

Important: Without the is_sandbox= true parameter, the response would be the ‘live’ response expected for those inputs.

Will we be billed for these queries? #

Yes, the customer will be billed for these queries. This is something we are working to address in upcoming updates. 

How about a sandbox environment for other APIs? #

The team is actively working to add the other APIs as well to our sandbox environment to help developers ensure appropriate integration.

Sandbox Query Examples: Phone Validation API #

Invalid Number #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?is_sandbox=true&phone=+13005550100' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.544fc1b5-a2cd-4d54-9a8f-628884ab0a2f",
    "phone_number": "+13005550100",
    "is_valid": false,
    "activity_score": null,
    "country_calling_code": null,
    "country_code": null,
    "country_name": null,
    "line_type": null,
    "carrier": null,
    "is_prepaid": null,
    "error": null,
    "warnings": [
        "Invalid Input"
    ]
}

Non-fixed VoIP Number #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?is_sandbox=true&phone=+13005550101' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.5f08eb8c-8470-4c68-b9f1-0104592fa213",
    "phone_number": "+13005550101",
    "is_valid": true,
    "activity_score": 60,
    "country_calling_code": "1",
    "country_code": "US",
    "country_name": "United States",
    "line_type": "NonFixedVOIP",
    "carrier": "IP Horizon LLC",
    "is_prepaid": false,
    "error": null,
    "warnings": []
}

Low Activity Score Number #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?is_sandbox=true&phone=+13005550102' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.0a7ac2c3-f1e9-4bfb-8d07-e69a5f2fbe17",
    "phone_number": "+13005550102 ",
    "is_valid": true,
    "activity_score": 10,
    "country_calling_code": "1",
    "country_code": "US",
    "country_name": "United States",
    "line_type": "Mobile",
    "carrier": "Verizon Wireless",
    "is_prepaid": false,
    "error": null,
    "warnings": []
}

Mobile, High Activity Score Number #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?is_sandbox=true&phone=+13005550103' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.e965754c-abef-4c71-bd51-152728c58b32",
    "phone_number": "+13005550103 ",
    "is_valid": true,
    "activity_score": 100,
    "country_calling_code": "1",
    "country_code": "US",
    "country_name": "United States",
    "line_type": "Mobile",
    "carrier": "T-Mobile USA, Inc.",
    "is_prepaid": false,
    "error": null,
    "warnings": []
}

International Number #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?is_sandbox=true&phone=+447463008000' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.f2509b5b-6d48-47d0-91d7-6e3d931b5762",
    "phone_number": "+447463008000",
    "is_valid": true,
    "activity_score": 80,
    "country_calling_code": "44",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "line_type": "Mobile",
    "carrier": "Vodafone United Kingdom",
    "is_prepaid": null,
    "error": null,
    "warnings": []
}

With Litigator Checks Add-On #

curl --location --request GET 
'https://api.trestleiq.com/3.0/phone_intel?phone=+13005550104&add_ons=litigator_checks&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.5d82d241-5160-4c33-a7f1-6bb986c5e4ed",
    "phone_number": "+13005550104",
    "is_valid": true,
    "activity_score": 100,
    "country_calling_code": "1",
    "country_code": "US",
    "country_name": "United States",
    "line_type": "Mobile",
    "carrier": "T-Mobile USA, Inc.",
    "is_prepaid": false,
    "add_ons": {
        "litigator_checks": {
            "phone.is_litigator_risk": true
        }
    },
    "error": null,
    "warnings": []
}

Sandbox Query Examples: Real Contact API 1.1 #

Invalid Phone #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?phone=300-555-0100&name=Jon%20Snow&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "phone.is_valid": false,
    "phone.activity_score": null,
    "phone.linetype": null,
    "phone.name_match": null,
    "phone.contact_grade": "F",
    "email.is_valid": null,
    "email.name_match": null,
    "email.contact_grade": null,
    "address.is_valid": null,
    "address.name_match": null,
    "errors": null,
    "warnings": [
        "Invalid Phone"
    ]
}

Invalid Address #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?phone=300-555-0103&name=Jon%20Snow&address.street_line_1=555%2055th%20St&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "phone.is_valid": true,
    "phone.activity_score": 100,
    "phone.linetype": "Mobile",
    "phone.name_match": true,
    "phone.contact_grade": "A",
    "email.is_valid": null,
    "email.name_match": null,
    "email.contact_grade": null,
    "address.is_valid": false,
    "address.name_match": null,
    "errors": null,
    "warnings": [
        "Invalid Address"
    ]
}

Phone Contact Grade-A #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?phone=300-555-0103&name=Jon%20Snow&address.street_line_1=103%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "phone.is_valid": true,
    "phone.activity_score": 100,
    "phone.linetype": "Mobile",
    "phone.name_match": true,
    "phone.contact_grade": "A",
    "email.is_valid": true,
    "email.name_match": true,
    "email.contact_grade": "A",
    "address.is_valid": true,
    "address.name_match": true,
    "errors": null,
    "warnings": []
}

Phone Grade-F #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?name=Jon%20Snow&email=jsnow%40mailnator.com&phone=300-555-0102&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "phone.is_valid": true,
    "phone.activity_score": 10,
    "phone.linetype": "Mobile",
    "phone.name_match": false,
    "phone.contact_grade": "F",
    "email.is_valid": true,
    "email.name_match": null,
    "email.contact_grade": "F",
    "address.is_valid": null,
    "address.name_match": null,
    "errors": null,
    "warnings": [
        "Disposable Email"
    ]
}

Litigator Check True and Low Email Age Score (via add_ons) #

curl --location --request GET 
'https://api.trestleiq.com/1.1/real_contact?phone=300-555-0104&name=Jon%20Snow&address.street_line_1=104%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&email=jsnow%40got.com&add_ons=litigator_checks%2Cemail_checks_age&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "phone.is_valid": true,
    "phone.activity_score": 100,
    "phone.linetype": "Mobile",
    "phone.name_match": true,
    "phone.contact_grade": "F",
    "email.is_valid": true,
    "email.name_match": null,
    "email.contact_grade": "F",
    "address.is_valid": true,
    "address.name_match": null,
    "add_ons": {
        "email_checks": {
            "email.age_score": 10.0
        },
        "litigator_checks": {
            "phone.is_litigator_risk": true
        }
    },
    "errors": null,
    "warnings": []
}

Sandbox Query Examples: Real Contact API 2.0 #

Invalid Phone #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0100&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "F",
    "is_valid": false,
    "activity_score": null,
    "line_type": null,
    "name_match": null,
  },
  "email": {
    "contact_grade": null,
    "is_valid": null,
    "name_match": null
  },
  "address": {
    "is_valid": null,
    "name_match": null
  },
  "ip_address": {
    "trust_score": null,
    "ip_distance_to_address": null
  },
  "warnings": [
"Invalid Phone"
],
  "errors": null
}

Invalid Address #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0103&address.street_line_1=555%2055th%20St&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "A",
    "is_valid": true,
    "activity_score": 100,
    "line_type": "Mobile",
    "name_match": true,
  },
  "email": {
    "contact_grade": null,
    "is_valid": null,
    "name_match": null
  },
  "address": {
    "is_valid": false,
    "name_match": null
  },
  "ip_address": {
    "trust_score": null,
    "ip_distance_to_address": null
  },
  "warnings": [
"Invalid Address"
],
  "errors": null
}

Phone Contact Grade-A #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0103&address.street_line_1=103%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&email=jsnow%40got.com&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "A",
    "is_valid": true,
    "activity_score": 100,
    "line_type": "Mobile",
    "name_match": true,
     }
  },
  "email": {
    "contact_grade": "A",
    "is_valid": true,
    "name_match": true
  },
  "address": {
    "is_valid": true,
    "name_match": true
  },
 "ip_address": {
    "trust_score": null,
    "ip_distance_to_address": null
  },
  "warnings": [],
  "errors": null
}

Phone Contact Grade-F #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0102&email=jsnow%40mailnator.com&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "F",
    "is_valid": true,
    "activity_score": 10,
    "line_type": "Mobile",
    "name_match": false,
  },
  "email": {
    "contact_grade": "F",
    "is_valid": true,
    "name_match": null
  },
  "address": {
    "is_valid": null,
    "name_match": null
  },
 "ip_address": {
    "trust_score": null,
    "ip_distance_to_address": null
  },
  "add_ons": null,
  "warnings": [
"Disposable Email
"],
  "errors": null
}

Litigator Check True and Low Email Age Score (via add_ons) #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0104&address.street_line_1=104%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&email=jsnow%40got.com&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "F",
    "is_valid": true,
    "activity_score": 100,
    "line_type": "Mobile",
    "name_match": true,
  },
  "email": {
    "contact_grade": "F",
    "is_valid": true,
    "name_match": null
  },
  "address": {
    "is_valid": true,
    "name_match": null
  },
 "ip_address": {
    "trust_score": null,
    "ip_distance_to_address": null
  },
  "add_ons": {
    "litigator_checks": {
      "phone_is_litigator_risk": true
    },
    "email_checks": {
      "email_age_score": 10
    }
  },
  "warnings": [],
  "errors": null
}

Low IP Trust Score + Large Distance #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0105&address.street_line_1=105%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&ip_address=192.0.2.1&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "A",
    "is_valid": true,
    "activity_score": 100,
    "line_type": "Mobile",
    "name_match": true,
    "name_match_details": {
      "match_type": "exact_match",
      "is_best_name": true,
      "confidence_score": null
    }
  },
  "email": {
    "contact_grade": null,
    "is_valid": null,
    "name_match": null
  },
  "address": {
    "is_valid": true,
    "name_match": true
  },
  "ip_address": {
    "trust_score": 30,
    "ip_distance_to_address": 3200
  },
  "warnings": [],
  "errors": null
}

High IP Trust Score + Close Distance #

curl --location --request GET 
'https://api.trestleiq.com/2.0/real_contact?name=Jon%20Snow&phone=300-555-0106&address.street_line_1=106%20Main%20Doors&address.city=Kings%20Landing&address.state_code=WA&address.postal_code=98101&ip_address=192.0.2.2&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
  "phone": {
    "contact_grade": "A",
    "is_valid": true,
    "activity_score": 100,
    "line_type": "Mobile",
    "name_match": true,
  },
  "email": {
    "contact_grade": null,
    "is_valid": null,
    "name_match": null
  },
  "address": {
    "is_valid": true,
    "name_match": true
  },
  "ip_address": {
    "trust_score": 85,
    "ip_distance_to_address": 12
  },
  "warnings": [],
  "errors": null
}

Sandbox Query Examples: Reverse Phone API #

Invalid Phone #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=300-555-0100&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": null,
    "phone_number": null,
    "is_valid": false,
    "country_calling_code": null,
    "line_type": null,
    "carrier": null,
    "is_prepaid": null,
    "is_commercial": null,
    "owners": [],
    "error": null,
    "warnings": [
        "Invalid Input"
    ]
}

Business Details Found #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=300-555-0105&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a1b3c4d5-6e78-4f90-8a1b-2c3d4e5f6789",
    "phone_number": "+13005550105",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "FixedVOIP",
    "carrier": "RingCentral",
    "is_prepaid": false,
    "is_commercial": true,
    "owners": [
        {
            "id": "Business.4f2a1b7c-9d83-41e2-8c5f-7a2d3e8b6f19",
            "name": “Iron Bank of Braavos",
            "firstname": null,
            "middlename": null,
            "lastname": null,
            "alternate_names": [],
            "age_range": null,
            "gender": null,
            "type": "Business",
            "industry": “Financial Services”,
            "link_to_phone_start_date": “2020-01-01”,
            "current_addresses": [
                {
                    "id": "Location.12ab34cd-56ef-47gh-89ij-01kl23mn45op",
                    "location_type": "Address",
                    "street_line_1": "451 Titan Ave",
                    "street_line_2": null,
                    "city": "Braavos",
                    "postal_code": "90001",
                    "zip4": "2291",
                    "state_code": "FC",
                    "country_code": "US",
                    "lat_long": {
                        "latitude": 43.4307,
                        "longitude": 11.3303,
                        "accuracy": "RoofTop"
                    },
                    "delivery_point": "MultiUnit",
                    "link_to_person_start_date": “2025-01-01”
                }
            ],
             "alternate_phones": [                
                {
                    "phoneNumber": "+13005550106",
                    "lineType": "Mobile"
                }
            ],
            "emails": [
                "freecityfinancing@titan.net"
            ]
        }
    ],
    "error": null,
    "warnings": []
}

Person Details Found #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=300-555-0103&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a9b0b97f-c9b0-4921-b8d2-1e63bbc17c9c",
    "phone_number": "+13005550103",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "Mobile",
    "carrier": "T-Mobile USA, Inc.",
    "is_prepaid": false,
    "is_commercial": false,
    "owners": [
        {
            "id": "Person.c7e4a2f1-3b59-4df8-87b6-2e49a9c1d045",
            "name": “Jon Snow",
            "firstname": “Jon”,
            "middlename": null,
            "lastname": “Snow”,
            "alternate_names": [
                "Jon Stark",
                "Aegon Targaryen",
                "The White Wolf"
            ],
            "age_range": “18-25”,
            "gender": “M”,
            "type": "Person",
            "industry": null,
            "link_to_phone_start_date": “2025-01-01”,
            "current_addresses": [
                {
                    "id": "Location.a93c2d4f-5e28-42f7-b91d-3f64a8e1d7cb",
                    "location_type": "Address",
                    "street_line_1": "103 Main Doors",
                    "street_line_2": “Throne Room”,
                    "city": "Kings Landing",
                    "postal_code": "98101",
                    "zip4": "1234",
                    "state_code": "WA",
                    "country_code": "US",
                    "lat_long": {
                        "latitude": 16.7702,
                        "longitude": 3.0083,
                        "accuracy": "RoofTop"
                    },
                    "delivery_point": "MultiUnit",
                    "link_to_person_start_date": “2025-01-01”
                }
            ],
             "alternate_phones": [                
                {
                    "phoneNumber": "+13005550104",
                    "lineType": "Mobile"
                }
            ],
            "emails": [
                "kinginthenorth@weirwood.net"
            ]
        }
    ],
    "error": null,
    "warnings": []
}

Person Name Only #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=300-555-0101&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.9d3a7f25-bc42-46e0-8a1d-2b18b84f3c6e",
    "phone_number": "+13005550101",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "NonFixedVOIP",
    "carrier": "IP Horizon LLC",
    "is_prepaid": false,
    "is_commercial": false,
    "owners": [
        {
            "id": "Person.77e4cc35-e327-4d5f-9bf0-f71d0fdf4ea8",
            "name": "Arya Stark",
            "firstname": "Arya",
            "middlename": null,
            "lastname": "Stark",
            "alternate_names": [
                "Cat of the Canals",
                "The Blind Girl",
                "Arya Horseface"
            ],
            "age_range": “18-25”,
            "gender": “F”,
            "type": "Person",
            "industry": null,
            "link_to_phone_start_date": “2025-01-01”,
            "current_addresses": [
                {
                    "id": "Location.a3f9b2c4-7d1e-4f6b-9e2a-5c8d1b7f2e90",
                    "location_type": "Address",
                    "street_line_1": “103 Westlands Ave”,
                    "street_line_2": null,
                    "city": "Off The Map",
                    "postal_code": "99999",
                    "zip4": “9999”,
                    "state_code": "XX",
                    "country_code": "XX",
                    "lat_long": {
                        "latitude": 24.0776,
                        "longitude": 74.4760,
                        "accuracy": "Rooftop"
                    },
                    "delivery_point": "SingleUnit",
                    "link_to_person_start_date": “2025-01-01”
                }
            ],
            "alternate_phones": [],
            "emails": []
        }
    ],
    "error": null,
    "warnings": []
}

No Owner Data #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=300-555-0102&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.3e7b2d1a-5c4f-48a9-8f6d-2b0e9c7a1d5f",
    "phone_number": "+13005550102",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "Mobile",
    "carrier": "Verizon Wireless",
    "is_prepaid": false,
    "is_commercial": null,
    "owners": [],
    "error": null,
    "warnings": []
}

International Number #

curl --location --request GET 
'https://api.trestleiq.com/3.2/phone?phone=34-222-555-555&is_sandbox=true' \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.5f8d2a4c-3b91-4e7f-9a2c-6d1e8b4f0a3b",
    "phone_number": "+34222555555",
    "is_valid": true,
    "country_calling_code": "34",
    "line_type": "Mobile",
    "carrier": "Vodafone D2",
    "is_prepaid": false,
    "is_commercial": false,
    "owners": [
        {
            "id": "Person.9b3e1f6a-7c4d-42a9-8f2b-5d0c7e1a3b8f",
            "name": "Khal Drogo",
            "firstname": "Khal",
            "middlename": null,
            "lastname": "Drogo",
            "alternate_names": [
                "The Great Khal",
                "My Sun and Stars"
            ],
           "age_range": “18-25”,
           "gender": “M”,
           "type": "Person",
           "industry": null,
           "link_to_phone_start_date": “2025-01-01”,
           "current_addresses": [
                {
                    "id": "Location.2d9f6b8c-1a4e-4f7d-9c3b-0e5a7f2d6b1c",
                    "location_type": "Address",
                    "street_line_1": “123 Grasslands Rd”,
                    "street_line_2": null,
                    "city": "Vaes Dothrak",
                    "postal_code": "88888",
                    "zip4": 8888,
                    "state_code": "DS",
                    "country_code": "ES",
                    "lat_long": {
                        "latitude": 47.9221,
                        "longitude": 106.9155,
                        "accuracy": "Rooftop"
                    },
                    "delivery_point": "MultiUnit",
                    "link_to_person_start_date": “2025-01-01”
                }
            ],
            "alternate_phones": [],
            "emails": []
        }
    ],
    "error": null,
    "warnings": []
}

Sandbox Query Examples: Caller Identification API #

Invalid Phone #

curl --location --request GET 
'https://api.trestleiq.com/3.1/caller_id?phone=+13005550100&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": null,
    "phone_number": null,
    "is_valid": false,
    "country_calling_code": null,
    "line_type": null,
    "carrier": null,
    "is_prepaid": null,
    "is_commercial": null,
    "belongs_to": null,
    "current_address": null,
    "emails": null,
    "error": null,
    "warnings": [
        "Invalid Input"
    ]
}

Person Name Found #

curl --location --request GET 
'https://api.trestleiq.com/3.1/caller_id?phone=+13005550103&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a9b0b97f-c9b0-4921-b8d2-1e63bbc17c9c",
    "phone_number": "+13005550103",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "Mobile",
    "carrier": "T-Mobile USA, Inc.",
    "is_prepaid": false,
    "is_commercial": false,
    "belongs_to": {
        "id": "Person.c7e4a2f1-3b59-4df8-87b6-2e49a9c1d045",
        "name": "Jon Snow",
        "firstname": "Jon",
        "middlename": null,
        "lastname": "Snow",
        "alternate_names":[
	"Jon Stark",
             "Aegon Targaryen",
             "The White Wolf"
         ],
        "age_range": “18-25”,
        "gender": “M”,
        "type": "Person",
        "industry": null,
        "link_to_phone_start_date": “2025-01-01”,
    },
    "current_address": {
        "id": "Location.a93c2d4f-5e28-42f7-b91d-3f64a8e1d7cb",
        "location_type": "Address",
        "street_line_1": "103 Main Doors",
        "street_line_2": “Throne Room”,
        "city": "Kings Landing",
        "postal_code": "98101",
        "zip4": "1234",
        "state_code": "WA",
        "country_code": "US",
        "lat_long": {
            "latitude": 16.7702,
            "longitude": 3.0083,
            "accuracy": "RoofTop"
        },
        "is_active": null,
        "delivery_point": "MultiUnit",
        "link_to_person_start_date": "2025-01-01"
    },
    "emails": [
"kinginthenorth@weirwood.net"
     ],
    "error": null,
    "warnings": []
}

Business Name Found #

curl --location --request GET 
'https://api.trestleiq.com/3.1/caller_id?phone=+13005550105&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a1b3c4d5-6e78-4f90-8a1b-2c3d4e5f6789",
    "phone_number": "+13005550105",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "FixedVOIP",
    "carrier": "RingCentral",
    "is_prepaid": false,
    "is_commercial": true,
    "belongs_to": {
        "id": "Business.4f2a1b7c-9d83-41e2-8c5f-7a2d3e8b6f19",
        "name": "Iron Bank of Braavos",
        "firstname": null,
        "middlename": null,
        "lastname": null,
        "alternate_names":[],
        "age_range": null,
        "gender": null,
        "type": "Business",
        "industry": null,
        "link_to_phone_start_date": “2025-01-01”,
    },
    "current_address": {
        "id": "Location.12ab34cd-56ef-47gh-89ij-01kl23mn45op",
        "location_type": "Address",
        "street_line_1": "451 Titan Ave",
        "street_line_2": null,
        "city": "Braavos”,
        "postal_code": "90001",
        "zip4": "2291",
        "state_code": "FC",
        "country_code": "US",
        "lat_long": {
            "latitude": 43.4307,
            "longitude": 11.3303,
            "accuracy": "RoofTop"
        },
        "is_active": null,
        "delivery_point": "MultiUnit",
        "link_to_person_start_date": "2025-01-01"
    },
    "emails": [
"freecityfinancing@titan.net"
     ],
    "error": null,
    "warnings": []
}

No Caller Identified #

curl --location --request GET 
'https://api.trestleiq.com/3.1/caller_id?phone=+13005550102&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.3e7b2d1a-5c4f-48a9-8f6d-2b0e9c7a1d5f",
    "phone_number": "+13005550102",
    "is_valid": true,
    "country_calling_code": "1",
    "line_type": "Mobile",
    "carrier": "Verizon Wireless",
    "is_prepaid": false,
    "is_commercial": null,
    "belongs_to": null,
    "current_address": {
        "id": “Location.8f2c5a1d-7b4e-43f9-9d3a-6e1b0c7f2d4a",
        "location_type": "PostalCode",
        "street_line_1": null,
        "street_line_2": null,
        "city": "Kings Landing",
        "postal_code": "98101",
        "zip4": 1234,
        "state_code": "KL",
        "country_code": “WE”,
        "lat_long": {
            "latitude": 17.7702,
            "longitude": 4.0083,
            "accuracy": "PostalCode"
        },
        "is_active": false,
        "delivery_point": "PartialAddress",
        "link_to_person_start_date": null
    },
    "emails": null,
    "error": null,
    "warnings": []
}

Sandbox Query Examples: Decision Signals API #

High Identity Score #

curl --location --request GET
  --url https://api.trestleiq.com/1.0/decision_signals?transaction_id=kushal-pos-1&transaction_time=2026-06-23%2010:00&primary.name=Jon%20Snow&primary.phone=%2B13005550201&primary.address.street_line_1=103%20Main%20Doors&primary.address.city=Kings%20Landing&primary.address.state_code=WA&primary.address.postal_code=98101&primary.email_address=jsnow@got.com&ip_address=192.0.2.1&secondary.name=Arya%20Stark&secondary.phone=%2B13005550202&secondary.address.street_line_1=980%20Kingsroad%20Way&secondary.address.city=Winterfell&secondary.address.state_code=WA&secondary.address.postal_code=99988&secondary.email_address=astark@got.com&is_sandbox=true
  --header 'x-api-key: [insert api_key]'
{
   "identity_score": 95,
   "upcoming_identity_score": null,
   "primary_phone_checks": {
       "is_valid": true,
       "country_code": "US",
       "is_commercial": false,
       "line_type": "Mobile",
       "carrier": "AT&T Wireless",
       "is_prepaid": false,
       "name_match": true,
       "address_match": "Match"
   },
   "secondary_phone_checks": {
       "is_valid": true,
       "country_code": "US",
       "is_commercial": false,
       "line_type": "Mobile",
       "carrier": "T-Mobile USA",
       "is_prepaid": false,
       "name_match": true,
       "address_match": "Match"
   },
   "primary_address_checks": {
       "is_valid": true,
       "is_commercial": false,
       "is_forwarder": false,
       "type": "Single Unit",
       "name_match": true
   },
   "secondary_address_checks": {
       "is_valid": true,
       "is_commercial": false,
       "is_forwarder": false,
       "type": "Single Unit",
       "name_match": true
   },
   "primary_email_address_checks": {
       "is_valid": true,
       "is_disposable": false,
       "email_age_score": 95,
       "email_domain_creation_days": 10000,
       "name_match": true
   },
   "secondary_email_address_checks": {
       "is_valid": true,
       "is_disposable": false,
       "email_age_score": 90,
       "email_domain_creation_days": 8000,
       "name_match": true
   },
   "ip_address_checks": {
       "is_valid": true,
       "trust_score": 92,
       "connection_type": null,
       "geolocation": {
           "subdivision": "Washington",
           "country_code": "US"
       },
       "distance_from_primary_address": 10,
       "distance_from_secondary_address": null,
       "distance_from_primary_phone": null,
       "distance_from_secondary_phone": null
   },
   "warnings": [],
   "errors": []
}

Low Trust Score #

curl --location --request GET
  --url https://api.trestleiq.com/1.0/decision_signals?transaction_id=kushal-neg-1&transaction_time=2026-06-23%2010:00&primary.name=Night%20King&primary.phone=%2B13005550204&primary.address.street_line_1=103%20Main%20Doors&primary.address.city=Kings%20Landing&primary.address.state_code=WA&primary.address.postal_code=98101&primary.email_address=shady@mailnator.com&ip_address=192.0.2.2&secondary.name=White%20Walker&secondary.phone=%2B13005550205&secondary.address.street_line_1=100%20Casterly%20Rock%20Ave&secondary.address.city=Lannisport&secondary.address.state_code=CA&secondary.address.postal_code=98402&secondary.email_address=spam@mailnator.com&is_sandbox=true
  --header 'x-api-key: [insert api_key]'
{
   "identity_score": 20,
   "upcoming_identity_score": null,
   "primary_phone_checks": {
       "is_valid": true,
       "country_code": "US",
       "is_commercial": false,
       "line_type": "NonFixedVOIP",
       "carrier": "IP Horizon LLC",
       "is_prepaid": true,
       "name_match": false,
       "address_match": "No Match"
   },
   "secondary_phone_checks": {
       "is_valid": true,
       "country_code": "US",
       "is_commercial": false,
       "line_type": "NonFixedVOIP",
       "carrier": "Bandwidth.com",
       "is_prepaid": true,
       "name_match": false,
       "address_match": "No Match"
   },
   "primary_address_checks": {
       "is_valid": true,
       "is_commercial": false,
       "is_forwarder": false,
       "type": "Single Unit",
       "name_match": false
   },
   "secondary_address_checks": {
       "is_valid": true,
       "is_commercial": false,
       "is_forwarder": true,
       "type": "Single Unit",
       "name_match": false
   },
   "primary_email_address_checks": {
       "is_valid": true,
       "is_disposable": true,
       "email_age_score": 5,
       "email_domain_creation_days": 30,
       "name_match": false
   },
   "secondary_email_address_checks": {
       "is_valid": true,
       "is_disposable": true,
       "email_age_score": 8,
       "email_domain_creation_days": 45,
       "name_match": false
   },
   "ip_address_checks": {
       "is_valid": true,
       "trust_score": 12,
       "connection_type": null,
       "geolocation": {
           "subdivision": "Bavaria",
           "country_code": "DE"
       },
       "distance_from_primary_address": 3200,
       "distance_from_secondary_address": null,
       "distance_from_primary_phone": null,
       "distance_from_secondary_phone": null
   },
   "warnings": [
       "Secondary Address: Freight Forwarder",
       "Primary Email: Disposable Email",
       "Secondary Email: Disposable Email",
       "IP: Proxy detected"
   ],
   "errors": []
}

Sandbox Query Examples: Smart CNAM API #

Invalid Phone #

curl --location --request GET 
'https://api.trestleiq.com/3.1/cnam?phone=3005550100&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": null,
    "is_valid": false,
    "phone_number": null,
    "belongs_to": null,
    "error": null,
    "warnings": [
        "Invalid Input"
    ]
}

Person Name Found #

curl --location --request GET 
'https://api.trestleiq.com/3.1/cnam?phone=3005550103&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a9b0b97f-c9b0-4921-b8d2-1e63bbc17c9c",
    "is_valid": true,
    "phone_number": "+13005550103",
    "belongs_to": {
        "id": "Person.c7e4a2f1-3b59-4df8-87b6-2e49a9c1d045",
        "name": "Jon Snow",
        "firstname": "Jon",
        "Middlename": null,
        "lastname": "Snow"
    },
    "error": null,
    "warnings": []
}

Business Name Found #

curl --location --request GET 
'https://api.trestleiq.com/3.1/cnam?phone=3005550105&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.a1b3c4d5-6e78-4f90-8a1b-2c3d4e5f6789",
    "is_valid": true,
    "phone_number": "+13005550105",
    "belongs_to": {
        "id": "Business.4f2a1b7c-9d83-41e2-8c5f-7a2d3e8b6f19",
        "name": "Iron Bank of Braavos",
        "firstname": null,
        "middlename": null,
        "lastname": null
    },
    "error": null,
    "warnings": []
}

No Name Found #

curl --location --request GET 
'https://api.trestleiq.com/3.1/cnam?phone=3005550102&is_sandbox=true \
  --header 'x-api-key: [insert api_key]'
{
    "id": "Phone.3e7b2d1a-5c4f-48a9-8f6d-2b0e9c7a1d5f",
    "is_valid": true,
    "phone_number": "+13005550102",
    "belongs_to": null,
    "error": null,
    "warnings": []
}