Skip to main content
POST
/
1.0
/
phone_feedback
POST https://api.trestleiq.com/1.0/phone_feedback

{
  "400": {},
  "403": {},
  "429": {},
  "500": {},
  "status": "<string>",
  "error": {}
}

​
Overview

Use the Phone Feedback API to submit the outcome of a phone call, including whether the call connected and if the number belonged to the right party. This helps improve data quality and enriches Trestle records.

​
Endpoint

POST https://api.trestleiq.com/1.0/phone_feedback

​
Headers

​
x-api-key
string
required
Your API key for authentication.

​
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
​
phone_right_party_contact
boolean
required
Indicates if the call confirmed the number belongs to the right party. Example: true

​
Code Examples

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
  }'
Postman payload 
{
  "method": "POST",
  "url": "https://api.trestleiq.com/1.0/phone_feedback",
  "headers": {
    "x-api-key": "YOUR_API_KEY",
    "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
  }
}

​
Response

​
status
string
Indicates whether the feedback was received successfully. Example: success
​
error
object
Returned when the request encounters a partial error due to external timeouts. Includes name and message fields.

​
Example Response

{
  "status": "success",
  "error": null
}

​
Error Responses

​
400
object
Bad Request - Invalid parameters or input error.
​
403
object
Forbidden - Invalid API key or access denied.
​
429
object
Too Many Requests - Rate limit exceeded.
​
500
object
Server Error - Internal server error.