For Developers: API Documentation
Easily retrieve call and SMS details from your application by sending a simple JSON request to our API endpoints.
Call Details Endpoint
URL
POST https://wizcaller.com/api/request/call-details/ |
Request Parameters
| Parameter | Type | Description |
|---|
CallSid | String | The unique CallSid of the call to retrieve details for. |
Response Parameters
| Parameter | Type | Description |
|---|
Twilio_CallSid | String | The unique identifier for the call. |
From | String | The phone number or client ID of the caller. |
To | String | The phone number or client ID of the recipient. |
Answered_By | String | The receiver of the incoming call (e.g., “Browser Call” or phone number). |
Twilio_Number_Name | String | The friendly name of the Twilio number used for the call. |
Time | String | The time when the call was made, in ISO 8601 format. |
Call_Duration | String | The duration of the call in hours, minutes, and seconds. |
Recording_Link | String | The URL to access the call recording, if available. |
New_Caller | String | Indicates if this is a new caller (“Yes” or “No”). |
Response Error Codes
| Code | Meaning |
|---|
| 200 | Success. The request was processed successfully, and call details are returned. |
| 400 | Bad Request. Missing parameters. This error appears when mandatory parameters are not provided. |
| 401 | Authentication Error. Invalid or expired API token. |
| 404 | Call Not Found. No call record matches the provided CallSid, or access is unauthorized. |
| 500 | Internal Server Error. An error occurred while processing the request. |
SMS Details Endpoint
URL
POST https://app.wizcaller.com/api/request/sms-details/ |
Request Parameters
| Parameter | Type | Description |
|---|
MessageSid | String | The unique MessageSid of the SMS to retrieve details for. |
Response Parameters
| Parameter | Type | Description |
|---|
Twilio_MessageSid | String | The unique identifier for the SMS message. |
From | String | The phone number or client ID of the sender. |
To | String | The phone number or client ID of the recipient. |
Twilio_Number_Name | String | The friendly name of the Twilio number used for the message. |
Time | String | The time when the message was sent, in ISO 8601 format. |
Message | String | The content of the SMS message. |
Response Error Codes
| Code | Meaning |
|---|
| 200 | Success. The request was processed successfully, and SMS details are returned. |
| 400 | Bad Request. Missing parameters. This error appears when mandatory parameters are not provided. |
| 401 | Authentication Error. Invalid or expired API token. |
| 404 | Message Not Found. No SMS record matches the provided MessageSid, or access is unauthorized. |
| 500 | Internal Server Error. An error occurred while processing the request. |
Authentication and Rate Limiting
To access these endpoints, you must include an Authorization header with a valid bearer token. Each user is limited to 60 requests per minute.
Example Authorization Header:
Authorization: Bearer <your-bearer-token> |
To get your bearer token, please reach out to support@wizcaller.com.
Example JSON Request
Call Details Request:
POST https://app.wizcaller.com/api/request/call-details/
Authorization: Bearer <your-api-token>
{
"CallSid": "CA12345678901234567890123456789012"
} |
SMS Details Request:
POST https://app.wizcallerapi/request/sms-details/
Authorization: Bearer <your-api-token>
{
"MessageSid": "SM12345678901234567890123456789012"
} |
Example JSON Response
Call Details Response:
{
"Twilio_CallSid": "CA12345678901234567890123456789012",
"From": "+1234567890",
"To": "+0987654321",
"Answered_By": "Browser Call",
"Twilio_Number_Name": "Support Line",
"Time": "2024-11-12T15:30:00Z",
"Call_Duration": "2 minutes 30 seconds",
"Recording_Link": "https://yourappdomain.com/play-recording/recording_code",
"New_Caller": "Yes"
} |
SMS Details Response:
{
"Twilio_MessageSid": "SM12345678901234567890123456789012",
"From": "+1234567890",
"To": "+0987654321",
"Twilio_Number_Name": "Support Line",
"Time": "2024-11-12T15:30:00Z",
"Message": "Hello, how can I assist you today?"
} |
