Skip to main content

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

string
required
Your API key for authentication. Example: {{ apiKey }}

Request Body

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

Response

string
Indicates whether the feedback was received successfully. Example: success
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. Error responses include an errorCode field identifying the cause:
  • Invalid API Key (INVALID_API_KEY): The key is incorrect, deactivated, or missing from the request. Check for: Trailing spaces, syntax errors, incorrect character counts, or a missing x-api-key header.
  • API Key Disabled (Portal Issue) (FORBIDDEN): 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) (FORBIDDEN): 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 (FORBIDDEN): 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 (RATE_LIMIT_EXCEEDED): You have surpassed the queries-per-second (QPS) threshold for your tier.
  • Quota Exceeded (Portal Issue) (QUOTA_EXCEEDED): 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.See Error handling for all error response bodies and codes.