Phone Feedback API

Phone Feedback API offers a method of providing feedback to Treslte about dialed numbers for their connected/disconnected status and confirmation of right party contact.

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.

Request
header Parameters
x-api-key
required
string

The API Key.

Example: {{apiKey}}
Request Body schema: application/json
required
response_id
string

The response ID from the Trestle API.

phone
string

The phone number in E.164 or local format. The default country calling code is +1 (USA).

name
string

Person or business name associated with the phone number.

phone_status
string

The status of the phone number from a live call, either 'Connected' or 'Disconnected'.

phone_right_party_contact
boolean

Indicates if it was confirmed during the call that the phone number belongs to the correct party.

Responses
200

Successful phone feedback response.

Response Schema: application/json
status
string

Whether the data was successfully received.

object

If the request encounters a partial error due to external timeouts.

400

Bad Request: Indicates that the server cannot process the request due to client-side errors.

403
  • Invalid API Key: Indicates that the API key is either incorrect or has been deactivated.
  • API Key Missing: Indicates that your request did not include an API key.
  • API Key Expired: Indicates that the API key has expired.
429

Too Many Requests: API Key has exceeded its rate limit.

500

Internal Server Error: Indicates that the server encountered an unexpected error.

post/1.0/phone_feedback
Request samples
application/json
{
  • "response_id": "T_b5d031b8-e8a3-4eef-8fa8-d87d3b7e386f",
  • "phone": "2069735100",
  • "name": "Waidong Syrws",
  • "phone_status": "Connected",
  • "phone_right_party_contact": true
}
Response samples
application/json
{
  • "status": "success",
  • "error": {
    }
}