Skip to main content
curl --location --request POST "https://api.trestleiq.com/1.0/phone_feedback" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "response_id": "T_b5d031b8-e8a3-4eef-8fa8-d87d3b7e386f",
    "phone": "2069735100",
    "name": "Waidong Syrws",
    "phone_status": "Connected",
    "phone_right_party_contact": true
  }'

{
  "status": "success",
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  }
}

curl --location --request POST "https://api.trestleiq.com/1.0/phone_feedback" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "response_id": "T_b5d031b8-e8a3-4eef-8fa8-d87d3b7e386f",
    "phone": "2069735100",
    "name": "Waidong Syrws",
    "phone_status": "Connected",
    "phone_right_party_contact": true
  }'

{
  "status": "success",
  "error": {
    "name": "InternalError",
    "message": "Could not retrieve entire response"
  }
}

​
Phone Feedback 1.0

Phone Feedback API allows you to submit phone feedback, including phone status and whether the phone number belongs to the right party based on a live call.

​
Headers

​
x-api-key
string
required
Your API key for authentication. Example: {{ apiKey }}

​
Request Body

​
response_id
string
required
The response ID returned from a prior Trestle API call. Example: T_b5d031b8-e8a3-4eef-8fa8-d87d3b7e386f
​
phone
string
required
The phone number in E.164 or local format. The default country calling code is +1 (USA). Example: 2069735100
​
name
string
Person or business name associated with the phone number. Example: Waidong Syrws
​
phone_status
string
required
Live-call status for the phone number. Possible values: Connected or Disconnected. Example: Connected Enum: Connected Disconnected
​
phone_right_party_contact
boolean
required
Indicates if the call confirmed the number belongs to the right party. Example: true

​
Response

​
status
string
Indicates whether the feedback was received successfully. Example: success
​
error
object(PartialError)
Error details in case of an error.

​
Error Responses

​
400 Bad Request

The server cannot process the request due to client-side errors.Check for: Syntax errors in the request script, malformed JSON, or invalid parameters.

​
403 Forbidden

The request is understood, but the server is refusing to fulfill it.
  • Invalid API Key: The key is incorrect or deactivated. Check for: Trailing spaces, syntax errors, or incorrect character counts.
  • API Key Missing: The request header did not include an API key.
  • API Key Disabled (Portal Issue): The key is inactive. Check for: Insufficient funds in your self-serve wallet or if a Trestle Admin manually deactivated your API key.
  • API Key does not have Product Access (Portal Issue): The API key is active, but it is not enabled for this product or API version. Check for: Incorrect endpoint, incorrect API version, or missing product access on the key.
  • API Key Expired: The key has reached its end-of-life (primarily affects Trial users).

​
429 Too Many Requests

You have sent too many requests in a given amount of time.
  • Rate Limit Exceeded: You have surpassed the queries-per-second (QPS) threshold for your tier.
  • Quota Exceeded (Portal Issue): You have reached the total volume allowed for your current billing cycle. Upgrade your plan in the portal to resume service.

​
500 Internal Server Error

An unexpected error occurred on the server side. Please contact support if this persists.