Methods
Objects
JSON Objects used in both the API and Real-Time.
Object | Description |
---|---|
Address | Postal Address |
Analytics.Calls.App | Analytics Calls by App |
Analytics.Calls.Country | Analytics Calls by Country |
Analytics.Calls.Destination | Analytics Calls by Destination |
Analytics.Calls.DID | Analytics Calls by DID |
Analytics.Calls.History | Analytics History |
Analytics.Calls.History.Call | Analytics Calls History (date) |
Analytics.Calls.Summary | Analytics (summary) |
Analytics.Calls.Summary.IN | Analytics Summary Calls IN |
Analytics.Calls.Summary.OUT | Analytics Summary Calls OUT |
Analytics.SMS.History | SMS Analytics History |
Analytics.SMS.History.OUT | SMS Analytics Calls History (date) |
Analytics.SMS.Summary | SMS Analytics (summary) |
Analytics.SMS.Summary.OUT | SMS Analytics Summary SMS OUT |
App | Voice App |
App.Package | Voice App Package |
App.Param.Vms | Voicemail |
App.Param.VmsDetect | Outbound Voicemail Detection |
App.SearchFilters | Search filters |
Authentication.ApiKey | Api-Key |
Authentication.Session | Session Token |
Calls.Broadcast1.Options | Calls Broadcast (1) Options |
CALLTRACKING10 | Call Tracking with call forwarding, prompts, and voicemail |
CALLTRACKING10.GA | CALLTRACKING10 Google Analytics |
CALLTRACKING10.Medias | CALLTRACKING10 Medias |
CALLTRACKING10.Options | CALLTRACKING10 Options |
CDR.In | Inbound Call Detail Record (CDR) |
CDR.Out | Outbound Call Detail Record (CDR) |
CDR.SearchFilters | Search filters |
CLICKTOCALL.Call | Click-to-Call Call |
CLICKTOCALL.Call.Status | Click-to-Call Call Status |
CLICKTOCALL.Start.Options | Click-to-Call Start Options |
CLICKTOCALL10 | Click-to-Call with dynamic A/B parties |
CLICKTOCALL10.Medias | CLICKTOCALL10 Medias |
CLICKTOCALL10.Options | CLICKTOCALL10 Options |
CONFERENCE10 | Conference Voice App |
CONFERENCE10.CallNumber.Options | Options when calling a number |
CONFERENCE10.Connected | Connected participant |
CONFERENCE10.Connected.History | Previously connected participant |
CONFERENCE10.ConnectionsHistory.Filters | Connections History listing filters. Each property is facultative. Set it to apply a filter. |
CONFERENCE10.ConnectionsHistory.Results | Connections History listing result object |
CONFERENCE10.Event | Room Event |
CONFERENCE10.Events.Filters | Events listing filters. Each property is facultative. Set it to apply a filter. |
CONFERENCE10.Events.Results | Events listing result object |
CONFERENCE10.Limits | Limits for CONFERENCE10 |
CONFERENCE10.Media | Media for CONFERENCE10 |
CONFERENCE10.Room | Conference Room (version 10) |
CONFERENCE10.Room.Access | Room Access for CONFERENCE10. |
CONFERENCE10.Room.Live | Conference Room (live) (version 10) |
Country | Country object |
Customer.CLI | Authorized Customer CLI |
DID | DID (Phone Number) |
DID.AreaCode | Area code |
DID.Country | DID Country |
DID.SearchFilters | DID Search filters |
DID.Store.Availability | DID Availability |
DID.Store.BuyStatus | DID Buy Status |
DID.Store.Contract | DID Reservation Contract |
DID.Store.Cost | DID Reservation Cost |
DID.Store.Error | DID Store Error |
DID.Store.Item | DID Item (phone number) in Store |
DID.Store.QuotaStatus | DID Store Quota Status |
DID.Store.Quote | DID Quote |
DID.Store.Reservation | DID Reservation Status |
DID.Type | DID type |
HLR.Response | HRL response |
Job | Job object |
Media.EmailTemplate | Email template object |
Media.Library | Media.Library object |
Media.Library.Overview | Library overview |
Media.Library.Overview.Count | Library overview (count) |
Media.Library.Overview.Ready | Library overview (ready) |
Media.PhoneID | Phone ID (DTMF sequence + phone number) |
Media.Quota | Media quota |
Media.Quota.Count | Media quota (count) |
Media.Quota.Quota | Media quota (quota) |
Media.Quota.Status | Media quota (status) |
Media.Recording | Media Recording |
Media.Recording.ActionResult | Recording Action Result |
Media.Recording.ActionResult.Error | Recording Action Result (error) |
Media.Recording.ListResult | Recording List Result |
Media.Recording.Options | The Media.Recording.Options object defines the following properties. |
Media.Recording.Overview | Recording overview |
Media.Recording.Overview.Status | Recording overview (status) |
Media.Recording.Overview.Status.Count | Recording overview (count) |
Media.Recording.Overview.Status.Ready | Recording overview (ready) |
Media.Recording.ReadStatus | Recording read status |
Media.Recording.ReadStatus.Status | Recording read status (status) |
Media.Recording.SearchFilters | Search filters |
Media.SearchFilters | Search filters |
Media.TTS.Options | Media Text-to-Speech Options |
NumberInfos | NumberInfos object |
Push.Hook.URL | Push Hook (push URL configuration) - deprecated object |
REALTIME10 | Realtime App. Allows you to control the call in Real-Time. |
REALTIME10.Call.Options | Realtime Call Options |
RT.Request | Real-Time Request (Our POST to your server) |
RT.Response | Real-Time Response (Your response to our requests). You have to send it within 5 seconds. The earliest, the better. |
Search.Options | Search options |
Search.Results | Search results |
Sendr.10.Addressbook | Addressbook |
Sendr.10.Addressbook.SearchFilters | Search filters |
Sendr.10.Blacklist | Black list (do not call) |
Sendr.10.Blacklist.SearchFilters | Search filters |
Sendr.10.Campaign | Campaign |
Sendr.10.Campaign.Blacklist | Campaign black list configuration |
Sendr.10.Campaign.Ivr.Sms.Simple | Simple SMS |
Sendr.10.Campaign.Ivr.Sms.Survey | Survey SMS |
Sendr.10.Campaign.Ivr.Voice.Action.Bridge | Bridge action |
Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email | Email sub action |
Sendr.10.Campaign.Ivr.Voice.Action.Broadcast | Broadcast action |
Sendr.10.Campaign.Ivr.Voice.Action.Callback | Callback action |
Sendr.10.Campaign.Ivr.Voice.Action.Email | Email action |
Sendr.10.Campaign.Ivr.Voice.Action.Record | Record action |
Sendr.10.Campaign.Ivr.Voice.Ivr | Instant voice response Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye. |
Sendr.10.Campaign.Ivr.Voice.IvrKey | IVR key |
Sendr.10.Campaign.Ivr.Voice.IvrKeys | IVR keys |
Sendr.10.Campaign.Ivr.Voice.Simple | Simple voice broadcasting. Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye. |
Sendr.10.Campaign.Ivr.Voice.Survey | Voice survey |
Sendr.10.Campaign.Ivr.Voice.Survey.Answer | Survey answer |
Sendr.10.Campaign.Ivr.Voice.Survey.Question | Survey question |
Sendr.10.Campaign.Options.AutoStopConditions | Auto-stop conditions |
Sendr.10.Campaign.Options.AutoStopConditions.PerAnswerCount | Auto-stop conditions: per-answer count |
Sendr.10.Campaign.Options.AutoStopConditions.PerKey | Auto-stop conditions: per-key count |
Sendr.10.Campaign.Options.Followup | Followup options |
Sendr.10.Campaign.Options.Followup.Actions | Followup actions |
Sendr.10.Campaign.Options.Followup.Actions.Callback | Followup actions (callback) |
Sendr.10.Campaign.Options.Followup.Actions.Sms | Followup actions (SMS) |
Sendr.10.Campaign.Options.Followup.Conditions | Followup conditions |
Sendr.10.Campaign.Options.SendReport | Report sending campaign options |
Sendr.10.Campaign.Options.Sms | SMS options |
Sendr.10.Campaign.Options.Voice | Voice options |
Sendr.10.Campaign.SearchFilters | Search filters |
Sendr.10.Campaign.Status | Campaign status |
Sendr.10.Campaign.Status.Sms.SentStatus | SMS Sent Statuses Number of SMS per status. |
Sendr.10.Campaign.Status.SmsSimple | Simple SMS campaign report status |
Sendr.10.Campaign.Status.SmsSurvey | Survey SMS campaign report status |
Sendr.10.Campaign.Status.Voice.CallStatus | Voice campaign call statuses |
Sendr.10.Campaign.Status.Voice.Keys | Voice campaign status per key pressed |
Sendr.10.Campaign.Status.Voice.Retries | Voice campaign retries |
Sendr.10.Campaign.Status.Voice.Retries.Causes | Voice campaign retries causes |
Sendr.10.Campaign.Status.VoiceIvr | Voice IVR campaign status |
Sendr.10.Campaign.Status.VoiceSimple | Simple Voice campaign status |
Sendr.10.Campaign.Status.VoiceSimple.Broadcast | Simple Voice campaign report brodcast status info |
Sendr.10.Campaign.Status.VoiceSurvey | Voice survey campaign status |
Sendr.10.Campaign.TestCall | Test call |
Sendr.10.Report | Sendr campaign report |
Sendr.10.Report.SearchFilters | Search filters |
SIP.Subscriber | SIP Subscriber |
SIP.Subscriber.Options | SIP Subscriber Options |
SIP.Subscriber.Properties | SIP Subscriber Properties |
SIP.Subscriber.SearchFilters | SIP Subscriber Search filters |
SIP.TrunkOrigination | SIP Trunk Origination |
SIP.TrunkOrigination.Options | SIP Trunk Origination Options |
SIP.TrunkOrigination.Properties | SIP Trunk Origination Properties |
SIP.TrunkOrigination.SearchFilters | SIP Trunk Origination Search filters |
SIP.TrunkTermination | SIP Trunk Termination |
SIP.TrunkTermination.Options | SIP Trunk Termination Options |
SIP.TrunkTermination.Properties | SIP Trunk Termination Properties |
SIP.TrunkTermination.SearchFilters | SIP Trunk Termination Search filters |
SMS | SMS text message |
SMS.Options | The SMS.Options object defines the following properties. |
SMS.Quote | Quote for a SMS |
SMS.SearchFilters | Search filters |
SubAccount | Sub Account |
SubAccount.Account | Sub Account Account |
SubAccount.Contact | Sub Account Contact |
SubAccount.CreateOptions | Sub Account Creation Options |
SubAccount.CreateOptions.Password | Sub Account Creation Options Password |
SubAccount.CreateParams | Sub Account Params Creation |
SubAccount.CreateParams.Billing | Sub Account Params Billing Creation |
SubAccount.CreateProperties | Sub Account Creation Properties |
SubAccount.Credentials | Sub Account Credentials |
SubAccount.EditOptions | Sub Account Edition Options |
SubAccount.EditParams | Sub Account Params Editable |
SubAccount.EditParams.Billing | Sub Account Params Billing Editable |
SubAccount.EditProperties | Sub Account Edition Properties |
SubAccount.Params | Sub Account Params |
SubAccount.Params.Billing | Sub Account Params Billing |
SubAccount.Params.Default | Sub Account Params Default |
SubAccount.Quota | Sub Account Quota |
SubAccount.SearchFilters | Sub Account Search filters |
SubAccount.State | Sub Account State |
SubAccount.TransferOptions | Sub Account Tranfer Options |
Target | Target (Phone number + timeout) |
THEDIALR20 | Realtime App. Allows you to control the call in Real-Time. WARNING: DEPRECATED by REALTIME10. |
Timezone | Timezone object |
Web.Push | Object pushed to a your callback URL. Deprecated. See webhooks! |
Webhook | Webhook object |
Webhook.Event | Webhook event object |
Webhook.Event.Billing.Credit | Webhook Credit event |
Webhook.Log.Search.Filters | Webhook log search filters |
Webhook.Options | Webhook options |
Postal Address
{
"city": "(string)",
"country": "FR",
"state": "(string)",
"street": "(string)",
"zip": "(string)"
}
Property | Type | Description |
---|---|---|
city | string |
The address city Format: address_city (City) |
country | string |
The address country Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
state | string |
The address state Format: address_state (State) |
street | string |
The address street name and number Format: address_street (Street name and number) |
zip | string |
The address zip code Format: address_zip (ZIP Code) |
Analytics Calls by App
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"hash": "UNIQUEID"
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
hash | string |
App ID Format: hash (Unique object identifier) |
Analytics Calls by Country
{
"aloc": 0,
"count": 0,
"country_code": "FR",
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
count | int | Calls count |
country_code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
Analytics Calls by Destination
{
"aloc": 0,
"billing_label": "(string)",
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
billing_label | string | Destination billing label |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
Analytics Calls by DID
{
"aloc": 0,
"billing_label": "(string)",
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"hash": "UNIQUEID",
"intl": "+33612345678"
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
billing_label | string | DID billing label |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
hash | string |
DID ID Format: hash (Unique object identifier) |
intl | string |
DID number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Analytics History
{
"IN": [],
"OUT": []
}
Property | Type | Description |
---|---|---|
IN | array |
Inbound calls Array of objects: Analytics.Calls.History.Call |
OUT | array |
Outbound calls Array of objects: Analytics.Calls.History.Call |
Analytics Calls History (date)
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"date": "2021-04-24 00:42:42",
"debit": "0.0000",
"duration": 0
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
date | string |
Date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
Analytics (summary)
{
"IN": {},
"OUT": {}
}
Property | Type | Description |
---|---|---|
IN | object |
Inbound calls Object: Analytics.Calls.Summary.IN |
OUT | object |
Outbound calls Object: Analytics.Calls.Summary.OUT |
Analytics Summary Calls IN
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0,
"unique_callers": 0
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
unique_callers | int | Unique callers |
Analytics Summary Calls OUT
{
"aloc": 0,
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"duration": 0
}
Property | Type | Description |
---|---|---|
aloc | int | Average length of call |
count | int | Calls count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
duration | int | Calls duration (answered) |
SMS Analytics History
{
"IN": [],
"OUT": []
}
Property | Type | Description |
---|---|---|
IN | array | Inbound calls |
OUT | array |
Outbound calls Array of objects: Analytics.SMS.History.OUT |
SMS Analytics Calls History (date)
{
"count": 0,
"credit": "0.0000",
"date": "2021-04-24 00:42:42",
"debit": "0.0000",
"parts": 0
}
Property | Type | Description |
---|---|---|
count | int | SMS count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
date | string |
Date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
parts | int | SMS parts (billed) |
SMS Analytics (summary)
{
"IN": {},
"OUT": {}
}
Property | Type | Description |
---|---|---|
IN | object | Inbound SMS |
OUT | object |
Outbound SMS Object: Analytics.SMS.Summary.OUT |
SMS Analytics Summary SMS OUT
{
"count": 0,
"credit": "0.0000",
"debit": "0.0000",
"parts": 0
}
Property | Type | Description |
---|---|---|
count | int | SMS count |
credit | string |
Credit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
debit | string |
Debit Format: amount_4 (amount in cents with 4 decimals. Example : "1000.0000" for 10 USD or EUR) |
parts | int | SMS parts (billed) |
Voice App
{
"date_creation": "2021-04-24 00:42:42",
"date_update": "2021-04-24 00:42:42",
"did": [],
"hash": "UNIQUEID",
"name": "(string)",
"p": {},
"package": {}
}
Property | Type | Description |
---|---|---|
date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_update | string |
Date of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
did | array |
DIDs assigned to the App Array of objects: DID |
hash | string |
App ID Format: hash (Unique object identifier) |
name | string | App name |
p | object |
App parameters Objects: CALLTRACKING10, CLICKTOCALL10, REALTIME10 |
package | object |
App package Object: App.Package |
Voice App Package
{
"has_did": true,
"name": "CLICKTOCALL10",
"type": "CLICKTOCALL"
}
Property | Type | Description |
---|---|---|
has_did | bool | Determines if the Voice App can be assigned a DID |
name | string |
Package name Values: "CALLTRACKING10", "CLICKTOCALL10", "REALTIME10" |
type | string |
Package type Values: "CALLTRACKING", "CLICKTOCALL", "THEDIALR" |
Voicemail
{
"active": true,
"email_template": "UNIQUEID",
"emails": [],
"file_format": "mp3",
"file_name": "(string)",
"intro": 0,
"locale": "(string)",
"record": true,
"timeout": 0,
"timezone": "(string)"
}
Property | Type | Description |
---|---|---|
active | bool | If not activated, the call is hang up |
email_template | string |
Email template Format: hash (Unique object identifier) |
emails | array | Email recipients |
file_format | string |
File attachment format Values: "mp3", "sln", "wav" |
file_name | string |
File attachment name Format: vms_file_name (Voicemail Recording Attachement filename. Use these tags to name the file. Example: "{CALLID}-{MEDIA_HASH}" or "{DATETIME}-{CALLID}") |
intro | int | Media prompt |
locale | string |
Locale used for date/time formatting Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
record | bool | if FALSE, the call is hang up after playing the prompt |
timeout | int | Max recording length in seconds. Must be 30 <= x <= 300. |
timezone | string |
Timezone IANA name Format: timezone_str (IANA timezone name. Example: "Europe/Paris".) |
Outbound Voicemail Detection
{
"active": true,
"dtmf_iterations": 0,
"dtmf_media": 0,
"dtmf_timeout": 0,
"method": "SILENCE",
"silence_iterations": 0,
"silence_media": 0,
"silence_ms": 0,
"silence_timeout": 0
}
Property | Type | Description |
---|---|---|
active | bool | Active ? |
dtmf_iterations | int | When using the DTMF method, how many times do we try to have a DTMF ? (default: 2) |
dtmf_media | int | When using the DTMF method, Media played before detection (default: 0) |
dtmf_timeout | int | When using the DTMF method, how long do we wait for a DTMF to be sent ? (default: 2) |
method | string |
Detection method Values: "DTMF", "SILENCE" |
silence_iterations | int | When using the SILENCE method, how many times do we try ? (default: 1, min: 1, max: 30) |
silence_media | int | When using the SILENCE method, Media played before detection (default: 0) |
silence_ms | int | When using the SILENCE method, how long must be the silence in milliseconds ? (default: 1800, min: 50, max: 10000) |
silence_timeout | int | When using the SILENCE method, how long do we try to detect silence ? (default: 3, min: 0, max: 120) |
Search filters
{
"name": "(string)"
}
Property | Type | Description |
---|---|---|
name | string | App name |
Api-Key
{
"created_at": "2021-04-24 00:42:42",
"last_used_at": "2021-04-24 00:42:42",
"name": "(string)",
"updated_at": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
created_at | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
last_used_at | string |
Date of last usage Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
name | string | Api-key name |
updated_at | string |
Date of update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Session Token
{
"refresh_token": "(string)",
"refreshable_until": "(string)",
"token": "(string)",
"valid_until": "(string)"
}
Property | Type | Description |
---|---|---|
refresh_token | string | Token for refreshing the current token |
refreshable_until | string | Date until this token can be refreshed |
token | string | Session token |
valid_until | string | Date until this token is still valid |
Calls Broadcast (1) Options
{
"cdr_field": "(string)",
"cli": "(string)",
"direct_to_voicemail": true,
"loop": 0
}
Property | Type | Description |
---|---|---|
cdr_field | string |
Custom field written in the CDR Format: cdr_customer_field (32 alphanumeric characters maximum) |
cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
direct_to_voicemail | bool | Leave voicemail without making the phone ring. Works only on mobile phones. |
loop | int | Play messages in a loop! min=1 max=10 |
Call Tracking with call forwarding, prompts, and voicemail
{
"ga": {},
"medias": {},
"options": {},
"targets": [],
"vms": {}
}
Property | Type | Description |
---|---|---|
ga | object |
Google Analytics Object: CALLTRACKING10.GA |
medias | object |
Medias Object: CALLTRACKING10.Medias |
options | object |
Options Object: CALLTRACKING10.Options |
targets | array |
Targets (Call forwarding) Array of objects: Target |
vms | object |
Voicemail Object: App.Param.Vms |
CALLTRACKING10 Google Analytics
{
"ua": "(string)"
}
Property | Type | Description |
---|---|---|
ua | string | Google Analytics Web Property ID |
CALLTRACKING10 Medias
{
"bridge": 0,
"ringtone": 0,
"welcome": 0,
"whisper": 0
}
Property | Type | Description |
---|---|---|
bridge | int | Played to both parties before bridging the call |
ringtone | int | Played while the target is ringing |
welcome | int | Played immediately to the caller |
whisper | int | Played to the target only (callee whispering) |
CALLTRACKING10 Options
{
"record_calls": true
}
Property | Type | Description |
---|---|---|
record_calls | bool | Activate call recording |
Inbound Call Detail Record (CDR)
{
"answer": "2021-04-24 00:42:42",
"billing_customer_cost_label": "(string)",
"billing_customer_credit_eur": "0.00",
"billing_customer_debit_eur": "0.00",
"callid": 0,
"cli_country_code": "FR",
"cli_name": "(string)",
"cli_number": "+447890123456",
"cli_number_type": "(string)",
"cli_pres": "allowed_passed_screen",
"customer_field": "(string)",
"did_hash": "UNIQUEID",
"did_intl_number": "+33612345678",
"duration": 0,
"duration_answered": 0,
"duration_billed": 0,
"hangup": "2021-04-24 00:42:42",
"hangupcause": 0,
"hangupsource": "GATEWAY",
"package_name": "(string)",
"scenario_hash": "UNIQUEID",
"scenario_name": "(string)",
"start": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
answer | string |
Call answer date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
billing_customer_cost_label | string | Billing destination name |
billing_customer_credit_eur | string |
Call credit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
billing_customer_debit_eur | string |
Call debit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
callid | int |
Unique call ID Format: callid (64-bit unsigned integer) |
cli_country_code | string |
CLI country code if available Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
cli_name | string | CLI name if available |
cli_number | string |
CLI number if available Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
cli_number_type | string | CLI number type if available |
cli_pres | string |
CLI presentation Values: "allowed_passed_screen", "prohib_passed_screen" |
customer_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
did_hash | string |
DID unique ID Format: hash (Unique object identifier) |
did_intl_number | string |
DID number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
duration | int | Call total duration in seconds |
duration_answered | int | Call answered duration in seconds |
duration_billed | int | Call billed duration in seconds |
hangup | string |
Call hangup date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hangupcause | int | ISDN cause code |
hangupsource | string |
Hangup source Values: "CALLEE", "CALLER", "GATEWAY" |
package_name | string | Package name |
scenario_hash | string |
Voice app ID Format: hash (Unique object identifier) |
scenario_name | string | Voice app name |
start | string |
Call start date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Outbound Call Detail Record (CDR)
{
"answer": "2021-04-24 00:42:42",
"billing_customer_cost_label": "(string)",
"billing_customer_credit_eur": "0.00",
"billing_customer_debit_eur": "0.00",
"callid": 0,
"callid_in": 0,
"cli_name": "(string)",
"cli_number": "+33612345678",
"cli_pres": "prohib_passed_screen",
"customer_field": "(string)",
"dialstatus": "NOANSWER",
"duration": 0,
"duration_answered": 0,
"duration_billed": 0,
"hangup": "2021-04-24 00:42:42",
"hangupcause": 0,
"hangupsource": "GATEWAY",
"number": "+33612345678",
"number_country_code": "FR",
"number_type": "(string)",
"package_name": "(string)",
"scenario_hash": "UNIQUEID",
"scenario_name": "(string)",
"start": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
answer | string |
Call answer date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
billing_customer_cost_label | string | Billing destination name |
billing_customer_credit_eur | string |
Call credit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
billing_customer_debit_eur | string |
Call debit (cents) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
callid | int |
Unique call ID Format: callid (64-bit unsigned integer) |
callid_in | int |
Inbound call ID if available Format: callid (64-bit unsigned integer) |
cli_name | string | CLI name if available |
cli_number | string |
CLI number if available Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
cli_pres | string |
CLI presentation Values: "allowed_passed_screen", "prohib_passed_screen" |
customer_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
dialstatus | string |
Dial status Values: "ANSWER", "BUSY", "CANCEL", "CHANUNAVAIL", "CONGESTION", "NOANSWER", "NODIAL" |
duration | int | Call total duration in seconds |
duration_answered | int | Call answered duration in seconds |
duration_billed | int | Call billed duration in seconds |
hangup | string |
Call hangup date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hangupcause | int | ISDN cause code |
hangupsource | string |
Hangup source Values: "CALLEE", "CALLER", "GATEWAY" |
number | string |
Outbound number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
number_country_code | string |
Number country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
number_type | string | Number type |
package_name | string | Package name |
scenario_hash | string |
Voice app ID Format: hash (Unique object identifier) |
scenario_name | string | Voice app name |
start | string |
Call start date and time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"app": "UNIQUEID",
"did": "UNIQUEID",
"from": "2021-04-24 00:42:42",
"hash": "UNIQUEID",
"to": "2021-04-24 00:42:42",
"type": "IN"
}
Property | Type | Description |
---|---|---|
app | string |
Voice App hash Format: hash (Unique object identifier) |
did | string |
DID hash Format: hash (Unique object identifier) |
from | string |
Retrieve from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string |
SMS Hash Format: hash (Unique object identifier) |
to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
type | string |
CDR type. This property MUST be filled. Values: "IN", "OUT" |
Click-to-Call Call
{
"a_status": {},
"a_targets": [],
"app": {},
"b_status": {},
"b_targets": [],
"cdr_field": "(string)",
"cli": "(string)",
"date_creation": "2021-04-24 00:42:42",
"date_scheduled": "2021-04-24 00:42:42",
"date_started": "2021-04-24 00:42:42",
"date_update": "2021-04-24 00:42:42",
"hash": "(string)"
}
Property | Type | Description |
---|---|---|
a_status | object |
Party A call status Object: CLICKTOCALL.Call.Status |
a_targets | array |
Targets called first ("A") Array of objects: Target |
app | object |
Voice App Object: App |
b_status | object |
Party B call status Object: CLICKTOCALL.Call.Status |
b_targets | array |
Targets called second ("B") Array of objects: Target |
cdr_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
cli | string |
CLI presented to party A. Party B will see the party A target number that answered the call Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
date_creation | string |
Date and time of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_scheduled | string |
Date and time scheduled Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_started | string |
Date and time started Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_update | string |
Date and time of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string | Call identifier |
Click-to-Call Call Status
{
"callid": 0,
"number": "+16469820800",
"status": "HANGUP",
"try": 0
}
Property | Type | Description |
---|---|---|
callid | int |
Call Unique ID (CDR) Format: callid (64-bit unsigned integer) |
number | string |
The number dialing or answered Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
status | string |
Call status Values: "ABORTED", "ANSWER", "DIALING", "HANGUP", "NOANSWER", "VOICEMAIL_DETECTED" |
try | int | Call try |
Click-to-Call Start Options
{
"cdr_field": "(string)",
"cli": "(string)",
"schedule": "(string)"
}
Property | Type | Description |
---|---|---|
cdr_field | string |
Custom CDR field Format: cdr_customer_field (32 alphanumeric characters maximum) |
cli | string |
CLI used to call A Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
schedule | string | Schedule the call in the future. Set any date in the past to start the call immediately |
Click-to-Call with dynamic A/B parties
{
"medias": {},
"options": {},
"vms": {}
}
Property | Type | Description |
---|---|---|
medias | object |
Medias Object: CLICKTOCALL10.Medias |
options | object |
Options Object: CLICKTOCALL10.Options |
vms | object |
Voicemail for A if B does not answer Object: App.Param.Vms |
CLICKTOCALL10 Medias
{
"A_ringtone": 0,
"A_welcome": 0,
"AB_bridge": 0,
"B_whisper": 0
}
Property | Type | Description |
---|---|---|
A_ringtone | int | Played to A while calling B |
A_welcome | int | Played to A immediately |
AB_bridge | int | Played to both parties before bridging the call |
B_whisper | int | Played to B only (A still hears the ringtone) |
CLICKTOCALL10 Options
{
"A_attempts": 0,
"A_retrypause": 0,
"A_vms_detect": {},
"B_vms_detect": {},
"record_calls": true
}
Property | Type | Description |
---|---|---|
A_attempts | int | Call attempts. Must be between 1 and 5 |
A_retrypause | int | Pause between attempts. Must be between 30 and 300 |
A_vms_detect | object |
Outbound voicemail detection on A Object: App.Param.VmsDetect |
B_vms_detect | object |
Outbound voicemail detection on B Object: App.Param.VmsDetect |
record_calls | bool | Active call recording |
Conference Voice App
{
"hook": {},
"limits": {},
"media": {},
"open": true,
"recording": "MANUAL"
}
Property | Type | Description |
---|---|---|
hook | object |
Push hook (push) Object: Push.Hook.URL |
limits | object |
Limits Object: CONFERENCE10.Limits |
media | object |
Media Object: CONFERENCE10.Media |
open | bool | Is the room open? When closed, no one can enter the room. |
recording | string |
Call recording Values: "AUTO", "MANUAL", "OFF" |
Options when calling a number
{
"date_expiration": "(string)",
"label": "(string)",
"level": "GUEST",
"max_duration": 0
}
Property | Type | Description |
---|---|---|
date_expiration | string | Expiration date |
label | string | Label |
level | string |
Level Values: "ADMIN", "GUEST" |
max_duration | int | Maximum duration |
Connected participant
{
"date_connection": "(string)",
"did_hash": "UNIQUEID",
"direction": "IN",
"duration": "(string)",
"hash": "UNIQUEID",
"location_city": "(string)",
"location_country": "FR",
"muted": true,
"paused": true,
"phone_number": "+16469820800",
"room_access_hash": "UNIQUEID",
"room_access_label": "(string)",
"room_access_level": "GUEST",
"room_hash": "UNIQUEID",
"status": "CONNECTING"
}
Property | Type | Description |
---|---|---|
date_connection | string | Date of connection |
did_hash | string |
DID ID (if inbound call) Format: hash (Unique object identifier) |
direction | string |
Call direction Values: "IN", "OUT" |
duration | string | Duration since connected in seconds |
hash | string |
Connected ID Format: hash (Unique object identifier) |
location_city | string | Connected location (city or area). May not be available. |
location_country | string |
Connected location (country code) Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
muted | bool | Is the connected muted? |
paused | bool | Is the connected paused? |
phone_number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
room_access_hash | string |
Room Access ID used to enter the room Format: hash (Unique object identifier) |
room_access_label | string | Room Access Label |
room_access_level | string |
Room Access Level Values: "ADMIN", "GUEST" |
room_hash | string |
Room ID Format: hash (Unique object identifier) |
status | string |
Status Values: "CONNECTED", "CONNECTING", "DISCONNECTED", "DISCONNECTING" |
Previously connected participant
{
"date_connection": "(string)",
"did_hash": "UNIQUEID",
"direction": "IN",
"duration": "(string)",
"hash": "UNIQUEID",
"last_status": "CONNECTED",
"location_city": "(string)",
"location_country": "FR",
"muted": true,
"paused": true,
"phone_number": "+16469820800",
"room_access_hash": "UNIQUEID",
"room_access_label": "(string)",
"room_access_level": "GUEST",
"room_hash": "UNIQUEID"
}
Property | Type | Description |
---|---|---|
date_connection | string | Date of connection |
did_hash | string |
DID ID (if inbound call) Format: hash (Unique object identifier) |
direction | string |
Call direction Values: "IN", "OUT" |
duration | string | Connected duration in seconds |
hash | string |
Connected ID Format: hash (Unique object identifier) |
last_status | string |
Last status before disconnection Values: "CONNECTED", "CONNECTING", "DISCONNECTED", "DISCONNECTING" |
location_city | string | Connected location (city or area). May not be available. |
location_country | string |
Connected location (country code) Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
muted | bool | Was the connected muted? |
paused | bool | Was the connected paused? |
phone_number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
room_access_hash | string |
Room Access ID used to enter the room Format: hash (Unique object identifier) |
room_access_label | string | Room Access Label |
room_access_level | string |
Room Access Level Values: "ADMIN", "GUEST" |
room_hash | string |
Room ID Format: hash (Unique object identifier) |
Connections History listing filters. Each property is facultative. Set it to apply a filter.
{
"action": "HANGUP",
"connected_hash": "UNIQUEID",
"room_access_hash": "UNIQUEID",
"room_hash": "UNIQUEID"
}
Property | Type | Description |
---|---|---|
action | string |
Filter on Event Action Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
connected_hash | string |
Filter on specific Connected ID Format: hash (Unique object identifier) |
room_access_hash | string |
Filter a Room Access ID Format: hash (Unique object identifier) |
room_hash | string |
Filter on Room ID Format: hash (Unique object identifier) |
Connections History listing result object
{
"items": [],
"total": 0,
"total_items": 0
}
Property | Type | Description |
---|---|---|
items | array |
Results Array of objects: CONFERENCE10.Connected.History |
total | int | Total available (without filters) |
total_items | int | Total returned (filtered) |
Room Event
{
"action": "LEAVE_ROOM",
"connected_count": 0,
"connected_hash": "(string)",
"data": {},
"date": "2021-04-24 00:42:42",
"from": "PHONE",
"room_access_hash": "(string)",
"room_access_label": "(string)"
}
Property | Type | Description |
---|---|---|
action | string |
Action. Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
connected_count | int | Number of connected in the room when the event is generated |
connected_hash | string | Connected ID (when applies) |
data | object | Event data. |
date | string |
Date/time of event Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
from | string |
Where did the event originated from? Values: "PHONE", "WEB" |
room_access_hash | string | Connected Room Access ID (when applies) |
room_access_label | string | Connected Room Access Label (when applies) |
Events listing filters. Each property is facultative. Set it to apply a filter.
{
"action": "ENTER_ROOM",
"connected_hash": "UNIQUEID",
"room_access_hash": "UNIQUEID",
"room_hash": "UNIQUEID"
}
Property | Type | Description |
---|---|---|
action | string |
Filter on Event Action Values: "ENTER_ROOM", "HANGUP", "INBOUND_CALL", "LEAVE_ROOM", "MUTE", "OUTBOUND_CALL", "OUTBOUND_CALL_STATUS", "PAUSE", "UNMUTE", "UNPAUSE" |
connected_hash | string |
Filter on specific Connected ID Format: hash (Unique object identifier) |
room_access_hash | string |
Filter a Room Access ID Format: hash (Unique object identifier) |
room_hash | string |
Filter on Room ID Format: hash (Unique object identifier) |
Events listing result object
{
"items": [],
"total": 0,
"total_items": 0
}
Property | Type | Description |
---|---|---|
items | array |
Results Array of objects: CONFERENCE10.Event |
total | int | Total available (without filters) |
total_items | int | Total returned (filtered) |
Limits for CONFERENCE10
{
"date_expiration": "2021-04-24 00:42:42",
"max_connected": 0,
"max_duration": 0
}
Property | Type | Description |
---|---|---|
date_expiration | string |
Conference expiration date and time. . Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
max_connected | int | Maximum number of connected (simultaneously). Use 0 to disable. |
max_duration | int | Maximum conference duration in seconds. When reached, the "$max_duration_reached" media is played and participants are hang up. Use 0 to disable. |
Media for CONFERENCE10
{
"alone": 0,
"bridge": 0,
"max_duration_reached": 0,
"out_confirm": 0,
"out_welcome": 0,
"pin_ask": 0,
"pin_invalid": 0,
"welcome": 0
}
Property | Type | Description |
---|---|---|
alone | int | Played to the participant if he's the first one |
bridge | int | Played right before entering the conference |
max_duration_reached | int | Played at the end of the conference if the max_duration is reached |
out_confirm | int | Played to the callee (outbound call) to confirm the call. Useful to detect voicemail. |
out_welcome | int | Played to the callee (outbound call) after optional '$out_confirm' |
pin_ask | int | Ask to input the pin code |
pin_invalid | int | Played when the pin code is not valid |
welcome | int | Played immediately to the participant (inbound call) |
Conference Room (version 10)
{
"a": [],
"date_creation": "2021-04-24 00:42:42",
"date_update": "2021-04-24 00:42:42",
"did": [],
"hash": "UNIQUEID",
"name": "(string)",
"p": {}
}
Property | Type | Description |
---|---|---|
a | array |
Room access Array of objects: CONFERENCE10.Room.Access |
date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_update | string |
Date of last update Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
did | array |
DIDs assigned to the Room Array of objects: DID |
hash | string |
Room ID Format: hash (Unique object identifier) |
name | string | Room name |
p | object |
Room parameters Object: CONFERENCE10 |
Room Access for CONFERENCE10.
{
"date_creation": "2021-04-24 00:42:42",
"date_expiration": "2021-04-24 00:42:42",
"date_update": "2021-04-24 00:42:42",
"did_hash": "UNIQUEID",
"hash": "UNIQUEID",
"label": "(string)",
"level": "ADMIN",
"max_duration": 0,
"phone_number": "+447890123456",
"pin": "(string)",
"room_hash": "UNIQUEID"
}
Property | Type | Description |
---|---|---|
date_creation | string |
Creation date/time. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_expiration | string |
Expiration date/time for this access. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_update | string |
Update date/time. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
did_hash | string |
DID ID. If != 0, the access will only apply to the specific DID. Format: hash (Unique object identifier) |
hash | string |
ID Format: hash (Unique object identifier) |
label | string | Label |
level | string |
Level. ADMIN users can enter a room even when it's full. Values: "ADMIN", "GUEST" |
max_duration | int | Maximum call duration for this access. |
phone_number | string |
Phone number used for outbound calls, and matched against the CLI for inbound calls. Use this field to assign an access to a specific phone number. Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
pin | string | PIN code. Digits only. If empty, no PIN will be asked. Maximum length = 8 digits. |
room_hash | string |
Room ID. Format: hash (Unique object identifier) |
Conference Room (live) (version 10)
{
"connected": [],
"hash": "UNIQUEID",
"name": "(string)",
"open": true,
"recording": true
}
Property | Type | Description |
---|---|---|
connected | array |
Array of currently connected participants Array of objects: CONFERENCE10.Connected |
hash | string |
Room ID Format: hash (Unique object identifier) |
name | string | Room name |
open | bool | Is the room open? |
recording | bool | Is recording on? |
Country object
{
"capital_code": "(string)",
"continent_code": "(string)",
"country_code": "FR",
"country_dialcode": "(string)",
"country_en_label": "(string)",
"country_fr_label": "(string)",
"country_label": "(string)",
"country_languages": "(string)",
"country_latitude": "(string)",
"country_localcode": "(string)",
"country_longitude": "(string)",
"country_neighbours": "FR",
"country_number_length": "(string)",
"country_tld": "(string)",
"currency_code": "(string)"
}
Property | Type | Description |
---|---|---|
capital_code | string | Country's Capital 3-letter code |
continent_code | string | Country's Continent 3-letter code |
country_code | string |
Country's Code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
country_dialcode | string | Country's E.164 Dialcode |
country_en_label | string | Country name (uppercase) in English |
country_fr_label | string | Country name (uppercase) in French |
country_label | string | Country name (lowercase) in English |
country_languages | string | Country's Languages |
country_latitude | string | Country's Latitude |
country_localcode | string | Country's Local code |
country_longitude | string | Country's Longitude |
country_neighbours | string |
Country's Neighbours comma separated Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
country_number_length | string | Country's Phone Numbers Length |
country_tld | string | Country's Top Level Domain (TLD) |
currency_code | string | Country's Currency |
Authorized Customer CLI
{
"cli": "(string)",
"comment": "(string)",
"label": "(string)"
}
Property | Type | Description |
---|---|---|
cli | string | Phone number/SMS Sender authorized |
comment | string | Custom comment |
label | string | Custom label |
DID (Phone Number)
{
"app": "UNIQUEID",
"class": "GOLD",
"country_code": "FR",
"hash": "UNIQUEID",
"intl_number": "+33612345678",
"local_number": "(string)",
"local_number_f": "(string)",
"type": "GEOGRAPHIC"
}
Property | Type | Description |
---|---|---|
app | string |
Voice App ID assigned to the DID, NULL otherwise Format: hash (Unique object identifier) |
class | string |
DID class Values: "CLASSIC", "GOLD" |
country_code | string |
DID country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
hash | string |
DID ID Format: hash (Unique object identifier) |
intl_number | string |
Phone number in international format Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
local_number | string | Phone number in local format |
local_number_f | string | Phone number in local format, formatted |
type | string |
DID type Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
Area code
{
"available": {},
"country_code": "FR",
"id": 0,
"intl_prefix": "(string)",
"label": "(string)",
"local_prefix": "(string)",
"type": "SMS-ONLY"
}
Property | Type | Description |
---|---|---|
available | object |
DID availability in the store for this area code Object: DID.Store.Availability |
country_code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
id | int | Area code ID |
intl_prefix | string | Area code international prefix |
label | string | Area code name (english) |
local_prefix | string | Area code local prefix |
type | string |
DID type of this area code Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
DID Country
{
"available": {},
"code": "FR",
"label": "(string)"
}
Property | Type | Description |
---|---|---|
available | object |
DID availability in the store for this country Object: DID.Store.Availability |
code | string |
Country code Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
label | string | Country name (english) |
DID Search filters
{
"class": "GOLD",
"hash": "UNIQUEID",
"type": "SPECIAL"
}
Property | Type | Description |
---|---|---|
class | string |
DID class Values: "CLASSIC", "GOLD" |
hash | string |
DID ID Format: hash (Unique object identifier) |
type | string |
DID type Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
DID Availability
{
"CLASSIC": 0,
"GOLD": 0
}
Property | Type | Description |
---|---|---|
CLASSIC | int | Number of CLASSIC numbers available |
GOLD | int | Number of GOLD numbers available |
DID Buy Status
{
"contract": {},
"cost": {},
"errors": [],
"success": []
}
Property | Type | Description |
---|---|---|
contract | object |
Subscription contract Object: DID.Store.Contract |
cost | object |
DIDs cost Object: DID.Store.Cost |
errors | array |
DIDs reserved but not bought Array of objects: DID.Store.Error |
success | array |
DIDs successfully bought. Array of objects: DID.Store.Item |
DID Reservation Contract
{
"billing_mode": "PREPAID",
"duration_month": 0,
"end_date": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
billing_mode | string |
Billing mode when buying DIDs. Values: "POSTPAID", "PREPAID" |
duration_month | int | Contract duration in month |
end_date | string |
Contract end date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
DID Reservation Cost
{
"amount_per_month": "0.00",
"amount_prepaid_debit": "0.00",
"amount_unit": "0.00",
"discount_percent": 0,
"quantity": 0,
"quantity_paying": 0
}
Property | Type | Description |
---|---|---|
amount_per_month | string |
DIDs cost (monthly) Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
amount_prepaid_debit | string |
Amount that will be debited from your prepaid credit (if your account is PREPAID). Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
amount_unit | string |
Cost per DID Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
discount_percent | int | Discount (percentage) applied to your order |
quantity | int | Number of DIDs reserved |
quantity_paying | int | Number of DIDs you will be paying (some contract have free DIDs included) |
DID Store Error
{
"code": 0,
"DID": {},
"message": "(string)"
}
Property | Type | Description |
---|---|---|
code | int | Error code |
DID | object |
DID with error Object: DID.Store.Item |
message | string | Error message |
DID Item (phone number) in Store
{
"hash": "UNIQUEID",
"intl_number": "(string)",
"local_number": "(string)"
}
Property | Type | Description |
---|---|---|
hash | string |
DID ID Format: hash (Unique object identifier) |
intl_number | string | Phone number (international) |
local_number | string | Phone number (national) |
DID Store Quota Status
{
"assigned_count": 0,
"assigned_max": 0,
"quota_current_count": 0,
"quota_current_remaining": 0,
"quota_max_over_period": 0,
"quota_period_days": 0
}
Property | Type | Description |
---|---|---|
assigned_count | int | Current number of DIDs assigned |
assigned_max | int | Max number of DIDs that can be assigned to your account, "-1" if unlimited. |
quota_current_count | int | Current number of DIDs you bought in "$quota_period_days" days. |
quota_current_remaining | int | Max number of DIDs you can buy given you previous orders, "-1" if unlimited. |
quota_max_over_period | int | Max number of DIDs you can buy over "$quota_period_days" days, "-1" if unlimited. |
quota_period_days | int | Quota period in days. |
DID Quote
{
"available": 0,
"contract": {},
"cost": {}
}
Property | Type | Description |
---|---|---|
available | int | Number of DIDs available based on your request |
contract | object |
Subscription contract Object: DID.Store.Contract |
cost | object |
DIDs cost Object: DID.Store.Cost |
DID Reservation Status
{
"contract": {},
"cost": {},
"expire": "2021-04-24 00:42:42",
"items": [],
"token": "(string)"
}
Property | Type | Description |
---|---|---|
contract | object |
Subscription contract Object: DID.Store.Contract |
cost | object |
DIDs cost Object: DID.Store.Cost |
expire | string |
Token expiration date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
items | array |
DIDs reserved. Array of objects: DID.Store.Item |
token | string | Order token |
DID type
{
"available": {},
"code": "TOLLFREE",
"label": "(string)"
}
Property | Type | Description |
---|---|---|
available | object |
DID availability in the store for this type Object: DID.Store.Availability |
code | string |
DID type code Values: "GEOGRAPHIC", "MOBILE", "NON-GEOGRAPHIC", "PERSONAL", "SHAREDREVENUE", "SMS-ONLY", "SPECIAL", "TOLLFREE" |
label | string | DID type label |
HRL response
{
"mcc": "(string)",
"mnc": "(string)",
"state": "FAILURE"
}
Property | Type | Description |
---|---|---|
mcc | string | Mobile Country Code |
mnc | string | Mobile Network Code |
state | string |
State Values: "FAILURE", "SUCCESS" |
Job object
{
"done_at": "2021-04-24 00:42:42",
"error": {},
"id": "(string)",
"percent": "(string)",
"result": {},
"status": "(string)"
}
Property | Type | Description |
---|---|---|
done_at | string |
Date and time of the process end Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
error | object | Error object if process failed. NULL if no error occurred. |
id | string |
Unique ID Format: hid (Unique object identifier) |
percent | string | Percentage of completion of the job. E.g.: "98.90", "100.00" |
result | object | Object containing the result of the process when done |
status | string | Status of the job. Can be one of : PENDING, RUNNING, CANCELED, DONE. |
Email template object
{
"hash": "UNIQUEID",
"name": "(string)",
"type": "VMS"
}
Property | Type | Description |
---|---|---|
hash | string |
Template ID Format: hash (Unique object identifier) |
name | string | Template name |
type | string |
Template type Values: "RECORD", "VMS" |
Media.Library object
{
"category": [],
"content": "(string)",
"duration": 0,
"hash": "UNIQUEID",
"id": 0,
"is_editable": true,
"language": [],
"name": "(string)",
"status": "ERROR",
"tags": {},
"url": "(string)",
"voice": "TTS_FR-FR_THOMAS"
}
Property | Type | Description |
---|---|---|
category | array | Media categories (string) |
content | string | Media text content if provided |
duration | int | Media duration |
hash | string |
Media Hash ID Format: hash (Unique object identifier) |
id | int | Media ID |
is_editable | bool | Is the media editable ? |
language | array |
Media languages Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
name | string | Media name |
status | string |
Media status Values: "ERROR", "PENDING_CONTENT", "PENDING_CONVERSION", "PROCESSING", "READY" |
tags | object | Dictionary (key/value) of tags. Key is the tag key (string). Value in an array of string (tag values). |
url | string | Media MP3 URL |
voice | string |
Text-to-Speech Voice ID Values: "TTS_DE-DE_ANNA", "TTS_DE-DE_YANNICK", "TTS_EN-GB_DANIEL", "TTS_EN-GB_SERENA", "TTS_FR-FR_AUDREY", "TTS_FR-FR_SEBASTIEN", "TTS_FR-FR_THOMAS", "TTS_FR-FR_VIRGINIE", "TTS_IT-IT_PAOLO", "TTS_IT-IT_SILVIA", "TTS_NL-BE_ELLEN", "TTS_NL-NL_CLAIRE", "TTS_NL-NL_XANDER" |
Library overview
{
"count": {},
"ready": {}
}
Property | Type | Description |
---|---|---|
count | object |
Quantities by status Object: Media.Library.Overview.Count |
ready | object |
Quantity and total size of READY media Object: Media.Library.Overview.Ready |
Library overview (count)
{
"ERROR": 0,
"PROCESSING": 0,
"READY": 0
}
Property | Type | Description |
---|---|---|
ERROR | int | Quantity of ERROR media |
PROCESSING | int | Quantity of PROCESSING media |
READY | int | Quantity of READY media |
Library overview (ready)
{
"count": 0,
"size": 0
}
Property | Type | Description |
---|---|---|
count | int | Quantity of READY media |
size | int | Total size of READY media (in bytes) |
Phone ID (DTMF sequence + phone number)
{
"code": "(string)",
"number": "+16469820800"
}
Property | Type | Description |
---|---|---|
code | string | DTMF sequence |
number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Media quota
{
"count": {},
"quota": {},
"status": {}
}
Property | Type | Description |
---|---|---|
count | object |
The quantity of media your have Object: Media.Quota.Count |
quota | object |
The quota you have bought Object: Media.Quota.Quota |
status | object |
Where you stand with your quota Object: Media.Quota.Status |
Media quota (count)
{
"library": 0,
"recording": 0
}
Property | Type | Description |
---|---|---|
library | int | Quantity of Library media |
recording | int | Quantity of Recordings media |
Media quota (quota)
{
"free": 0,
"paid": 0,
"unit": "(string)"
}
Property | Type | Description |
---|---|---|
free | int | Free storage (GB) |
paid | int | Paid storage (GB) |
unit | string | Storage unit (always "GB") |
Media quota (status)
{
"unit": "(string)",
"unused": "(string)",
"used": "(string)",
"used_by_library": "(string)",
"used_by_recording": "(string)"
}
Property | Type | Description |
---|---|---|
unit | string | Storage unit ("B","KB","MB","GB", etc.) |
unused | string | Storage unused |
used | string | Storage used (total) |
used_by_library | string | Storage used by library |
used_by_recording | string | Storage used by recordings |
Media Recording
{
"app_hash": "UNIQUEID",
"app_name": "(string)",
"callid": 0,
"cli_name": "(string)",
"cli_number": "+16469820800",
"date": "2021-04-24 00:42:42",
"date_read": "2021-04-24 00:42:42",
"did_hash": "UNIQUEID",
"did_intl_number": "+16469820800",
"did_local_number": "(string)",
"duration": 0,
"file_size_total": 0,
"hash": "UNIQUEID",
"options": {},
"read": true,
"status": "READY",
"type": "RECORDING",
"url": "(string)",
"url_exts": []
}
Property | Type | Description |
---|---|---|
app_hash | string |
App ID Format: hash (Unique object identifier) |
app_name | string | App name |
callid | int |
Call ID (CDR) Format: callid (64-bit unsigned integer) |
cli_name | string | Caller ID (name) |
cli_number | string |
Caller ID (number) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
date | string |
Date and time of the recording Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_read | string |
Date and time when the recording was read Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
did_hash | string |
DID ID (if the recording is linked to a DID) Format: hash (Unique object identifier) |
did_intl_number | string |
DID number (international format) (if the recording is linked to a DID) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
did_local_number | string | DID number (national format) (if the recording is linked to a DID) |
duration | int | Recording duration (seconds) |
file_size_total | int | File size in bytes |
hash | string |
Recording ID Format: hash (Unique object identifier) |
options | object |
Recording Options Object: Media.Recording.Options |
read | bool | Read status |
status | string |
Status Values: "ERROR", "PENDING", "PROCESSING", "READY", "RECORDING" |
type | string |
Recording types Values: "CALL", "CONFERENCE", "RECORDING", "VOICEMAIL" |
url | string | URL of the recording without the extension |
url_exts | array | Array of available extensions (ususally "mp3") |
Recording Action Result
{
"errors": [],
"success": 0
}
Property | Type | Description |
---|---|---|
errors | array |
Array of Recordings (action failed) Array of objects: Media.Recording.ActionResult.Error |
success | int | Quantity of successful actions |
Recording Action Result (error)
{
"code": 0,
"hash": "UNIQUEID",
"message": "(string)"
}
Property | Type | Description |
---|---|---|
code | int | Error Code |
hash | string |
Recording ID Format: hash (Unique object identifier) |
message | string | Error message |
Recording List Result
{
"items": [],
"total_items": 0
}
Property | Type | Description |
---|---|---|
items | array |
Recordings Array of objects: Media.Recording |
total_items | int | Number of items |
The Media.Recording.Options object defines the following properties.
{
"webhook": {}
}
Property | Type | Description |
---|---|---|
webhook | object |
Dynamic webhook for this Media Recording. Status updates will be set to this specific webhook (and also to your "media.recording.new" and "media.recording.status_update" subscriptions). You only need to set 'endpoint' and optionally 'options'. Object: Webhook |
Recording overview
{
"CALL": {},
"CONFERENCE": {},
"RECORDING": {},
"VOICEMAIL": {}
}
Property | Type | Description |
---|---|---|
CALL | object |
Media of type CALL Object: Media.Recording.Overview.Status |
CONFERENCE | object |
Media of type CONFERENCE Object: Media.Recording.Overview.Status |
RECORDING | object |
Media of type RECORDING Object: Media.Recording.Overview.Status |
VOICEMAIL | object |
Media of type VOICEMAIL Object: Media.Recording.Overview.Status |
Recording overview (status)
{
"count": {},
"ready": {}
}
Property | Type | Description |
---|---|---|
count | object |
Quantities by status Object: Media.Recording.Overview.Status.Count |
ready | object |
Quantity and total size of READY media Object: Media.Recording.Overview.Status.Ready |
Recording overview (count)
{
"ERROR": 0,
"PROCESSING": 0,
"READY": 0,
"RECORDING": 0
}
Property | Type | Description |
---|---|---|
ERROR | int | Quantity of ERROR media |
PROCESSING | int | Quantity of PROCESSING media |
READY | int | Quantity of READY media |
RECORDING | int | Quantity of RECORDING media |
Recording overview (ready)
{
"count": 0,
"read": 0,
"size": 0,
"unread": 0
}
Property | Type | Description |
---|---|---|
count | int | Quantity of READY media |
read | int | Quantity of READY media (read) |
size | int | Total size of READY media (in bytes) |
unread | int | Quantity of READY media (unread) |
Recording read status
{
"CALL": {},
"CONFERENCE": {},
"RECORDING": {},
"VOICEMAIL": {}
}
Property | Type | Description |
---|---|---|
CALL | object |
Media of type CALL Object: Media.Recording.ReadStatus.Status |
CONFERENCE | object |
Media of type CONFERENCE Object: Media.Recording.ReadStatus.Status |
RECORDING | object |
Media of type RECORDING Object: Media.Recording.ReadStatus.Status |
VOICEMAIL | object |
Media of type VOICEMAIL Object: Media.Recording.ReadStatus.Status |
Recording read status (status)
{
"count": 0,
"read": 0,
"unread": 0
}
Property | Type | Description |
---|---|---|
count | int | Quantity of media |
read | int | Quantity of media (read) |
unread | int | Quantity of media (unread) |
Search filters
{
"callid": 0,
"cli_number": "+16469820800",
"created_at_from": "2021-04-24 00:42:42",
"created_at_to": "2021-04-24 00:42:42",
"hash": "UNIQUEID",
"read": true,
"read_at_from": "2021-04-24 00:42:42",
"read_at_to": "2021-04-24 00:42:42",
"status": "PENDING",
"type": "RECORDING"
}
Property | Type | Description |
---|---|---|
callid | int |
Call ID (from CDR) Format: callid (64-bit unsigned integer) |
cli_number | string |
Caller ID (number) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
created_at_from | string |
Retrieve media recorded from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
created_at_to | string |
Retrieve media recorded until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string |
Media Hash Format: hash (Unique object identifier) |
read | bool | Wether or not the media has been read |
read_at_from | string |
Retrieve media read from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
read_at_to | string |
Retrieve media read until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
status | string |
Media status Values: "ERROR", "PENDING", "PROCESSING", "READY", "RECORDING" |
type | string |
Type of recording Values: "CALL", "CONFERENCE", "RECORDING", "VOICEMAIL" |
Search filters
{
"category": "RINGTONE",
"created_at_from": "2021-04-24 00:42:42",
"created_at_to": "2021-04-24 00:42:42",
"hash": "UNIQUEID",
"id": 0,
"language": [],
"name": "(string)",
"status": "ERROR",
"tags_type": "(string)",
"tags_value": "(string)",
"voice": "TTS_NL-NL_XANDER"
}
Property | Type | Description |
---|---|---|
category | string |
Media category Values: "FAILURE", "IVR", "MISC", "RINGTONE", "VOICEMAIL", "WELCOME", "WHISPER" |
created_at_from | string |
Retrieve from this date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
created_at_to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string |
Media Hash Format: hash (Unique object identifier) |
id | int | Media ID |
language | array |
Media languages Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
name | string | Name |
status | string |
Media status Values: "ERROR", "PENDING_CONTENT", "PENDING_CONVERSION", "PROCESSING", "READY" |
tags_type | string | Media tag type, key used when calling media/library.set_tags |
tags_value | string | Media tag value, value used when calling media/library.set_tags |
voice | string |
Text-to-Speech Voice ID Values: "TTS_DE-DE_ANNA", "TTS_DE-DE_YANNICK", "TTS_EN-GB_DANIEL", "TTS_EN-GB_SERENA", "TTS_FR-FR_AUDREY", "TTS_FR-FR_SEBASTIEN", "TTS_FR-FR_THOMAS", "TTS_FR-FR_VIRGINIE", "TTS_IT-IT_PAOLO", "TTS_IT-IT_SILVIA", "TTS_NL-BE_ELLEN", "TTS_NL-NL_CLAIRE", "TTS_NL-NL_XANDER" |
Media Text-to-Speech Options
{
"rate": 0
}
Property | Type | Description |
---|---|---|
rate | int | Speech rate. min:1 max:100 default:50 |
NumberInfos object
{
"country_code": "FR",
"intl_code": "(string)",
"intl_max_length": "(string)",
"intl_min_length": "(string)",
"intl_number": "+447890123456",
"is_valid": true,
"local_number": "(string)",
"local_prefix": "(string)",
"location": "(string)",
"type": "(string)"
}
Property | Type | Description |
---|---|---|
country_code | string |
Phone number country Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
intl_code | string | International dial code |
intl_max_length | string | Phone number maxmimum length |
intl_min_length | string | Phone number minimum length |
intl_number | string |
Phone number in international format Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
is_valid | bool | Indicate if the phone number is correctly formatted |
local_number | string | Phone number in local format |
local_prefix | string | Local (in country) dial prefix |
location | string | Phone number location (not always accurate) |
type | string | Phone number type (not always accurate) |
Push Hook (push URL configuration) - deprecated object
{
"auth": "(string)",
"url": "(string)"
}
Property | Type | Description |
---|---|---|
auth | string |
Basic HTTP Authentication (login:password) Format: http_basic_auth (login:password used for Basic HTTP Authentication) |
url | string |
Your URL Format: url (HTTP(S) URL) |
Realtime App. Allows you to control the call in Real-Time.
{
"data_format": "JSON",
"login": "(string)",
"password": "(string)",
"url": "(string)"
}
Property | Type | Description |
---|---|---|
data_format | string |
Data format. The only format supported right now is "JSON" Values: "JSON" |
login | string | Login if your URL is password protected (HTTP Basic Authentication) |
password | string | Password If your URL is password protected (HTTP Basic Authentication) |
url | string | Your URL callback. Our system will POST call status to your URL, and your answers will control the call |
Realtime Call Options
{
"cdr_field": "(string)",
"cli": "(string)"
}
Property | Type | Description |
---|---|---|
cdr_field | string |
Custom field written in the CDR. Format: cdr_customer_field (32 alphanumeric characters maximum) |
cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
Real-Time Request (Our POST to your server)
{
"app": "UNIQUEID",
"call_status": "INCOMING_CALL",
"callid": 0,
"cdr_field": "(string)",
"cli_name": "(string)",
"cli_number": "(string)",
"command": "(string)",
"command_error": "(string)",
"command_id": 42,
"command_result": "(string)",
"date_started": "2021-04-24 00:42:42",
"number": "+33612345678",
"request_hash": "UNIQUEID",
"variables": {}
}
Property | Type | Description |
---|---|---|
app | string |
Voice App ID Format: hash (Unique object identifier) |
call_status | string |
Call status. Values: "BUSY", "CONGESTION", "HANGUP", "INCOMING_CALL", "NOANSWER", "REJECTED", "UP" |
callid | int |
Call Unique ID (CDR) Format: callid (64-bit unsigned integer) |
cdr_field | string |
Custom field set by you when making the call Format: cdr_customer_field (32 alphanumeric characters maximum) |
cli_name | string | CLI name |
cli_number | string | CLI number |
command | string | The command name related to this request. |
command_error | string | The command error (if any) related to this request. |
command_id | mixed | The command id related to this request. |
command_result | string | The command result related to this request. |
date_started | string |
When the call has started Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
number | string |
DID/Outbound phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
request_hash | string |
Outbound Request ID (if outbound call) Format: hash (Unique object identifier) |
variables | object | Key/Value object sent back with each request. You can use this as a session object. |
Real-Time Response (Your response to our requests). You have to send it within 5 seconds. The earliest, the better.
{
"command": "(string)",
"command_id": 42,
"params": {},
"variables": {}
}
Property | Type | Description |
---|---|---|
command | string | The command we have to execute (see the commands list in Real-Time) |
command_id | mixed | Command ID. Use the value you want. We will send this ID back when we have the result ready. Useful to keep track of your scenario. |
params | object | Command parameters. See the Real-Time commands. |
variables | object | Key/Value object. You can fill this object with anything, we will send it back without touching it in our next request. You can use this as a session object. |
Search options
{
"offset": 0,
"order": "(string)",
"quantity": 0
}
Property | Type | Description |
---|---|---|
offset | int | Start index (zero-based) |
order | string | Order by |
quantity | int | Limit quantity |
Search results
{
"has_more": true,
"hits": [],
"offset": 0,
"total": 0
}
Property | Type | Description |
---|---|---|
has_more | bool | More items available |
hits | array | Hits |
offset | int | Current index |
total | int | Total available |
Addressbook
{
"content_header": [],
"description": "(string)",
"hash": "(string)",
"imported_at": "2021-04-24 00:42:42",
"in_use": true,
"items_count": 0,
"name": "(string)"
}
Property | Type | Description |
---|---|---|
content_header | array | Headers |
description | string | Description |
hash | string | ID |
imported_at | string |
Import date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
in_use | bool | Is the addressbook currently in use? |
items_count | int | Numbers of items in addressbook |
name | string | Name |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}
Property | Type | Description |
---|---|---|
hash | string | ID filter |
keywords | string | Keywords |
name | string | Name filter |
Black list (do not call)
{
"content_header": [],
"created_at": "2021-04-24 00:42:42",
"hash": "(string)",
"items_count": 0,
"name": "(string)",
"updated_at": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
content_header | array | Headers |
created_at | string |
Creation date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string | ID |
items_count | int | Numbers of items in black list |
name | string | Name |
updated_at | string |
Update date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}
Property | Type | Description |
---|---|---|
hash | string | ID filter |
keywords | string | Keywords |
name | string | Name filter |
Campaign
{
"created_at": "2021-04-24 00:42:42",
"hash": "(string)",
"ivr": {},
"name": "(string)",
"options": {},
"report": true,
"status": {},
"type": "VOICE_IVR",
"updated_at": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
created_at | string |
Creation date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
hash | string | ID |
ivr | object |
Scenario / Call flow Objects: Sendr.10.Campaign.Ivr.Sms.Simple, Sendr.10.Campaign.Ivr.Sms.Survey, Sendr.10.Campaign.Ivr.Voice.Simple, Sendr.10.Campaign.Ivr.Voice.Survey, Sendr.10.Campaign.Ivr.Voice.Ivr |
name | string | Name |
options | object |
Options Objects: Sendr.10.Campaign.Options.Voice, Sendr.10.Campaign.Options.Sms |
report | bool | Is a report available? |
status | object |
Status Object: Sendr.10.Campaign.Status |
type | string |
Type Values: "SMS_SIMPLE", "SMS_SURVEY", "VOICE_IVR", "VOICE_SIMPLE", "VOICE_SURVEY" |
updated_at | string |
Update date Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Campaign black list configuration
{
"method": "ALL",
"selected": []
}
Property | Type | Description |
---|---|---|
method | string |
Should we filter the address book? Values: "ALL", "NONE", "SELECT" |
selected | array |
Specific list of black lists to apply. If empty, all black lists are applied. Format: hash (Unique object identifier) |
Simple SMS
{
"encoding": "(string)",
"optout_confirmed": "(string)",
"optout_suffix": "(string)",
"sender": "(string)",
"text": "(string)"
}
Property | Type | Description |
---|---|---|
encoding | string | Encoding of the SMS. Can be GSM or UNICODE. |
optout_confirmed | string | Message sent to users to confirm an optout |
optout_suffix | string | Message appended at the end of the SMS for optout information |
sender | string |
Sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
text | string | Text |
Survey SMS
{
"final_text": "(string)",
"sender": "(string)",
"texts": []
}
Property | Type | Description |
---|---|---|
final_text | string | Last message sent (no reply expected) |
sender | string |
Sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
texts | array | Survey questions. Each question is sent after the previous one has been answered. |
Bridge action
{
"broadcast": [],
"email": {},
"noanswer": true,
"ringtone": [],
"targets": [],
"voicemail": {},
"whisper": []
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
object |
Send email? Object: Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email |
|
noanswer | bool | Played if targets do not answer |
ringtone | array | Played while dialing targets. Leave empty for default ringtone. |
targets | array |
Phone targets Array of objects: Target |
voicemail | object |
If targets do not answer, voicemail settings. Object: Sendr.10.Campaign.Ivr.Voice.Action.Bridge.Email |
whisper | array | Played to targets ONLY before bridging the call |
Email sub action
{
"emails": [],
"enabled": true,
"template": "(string)"
}
Property | Type | Description |
---|---|---|
emails | array | Emails |
enabled | bool | Enabled? |
template | string | Email template |
Broadcast action
{
"broadcast": [],
"goodbye": [],
"prompt": []
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
goodbye | array | Played after the prompt |
prompt | array | Prompt to listen the broadcast again (key "1"), or go back to the main menu (key "") |
Callback action
{
"broadcast": [],
"delay": 0
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
delay | int | Delay (minutes) before calling back (5..240) |
Email action
{
"broadcast": [],
"emails": [],
"template": "(string)"
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
emails | array | Emails |
template | string | Email template |
Record action
{
"broadcast": [],
"emails": [],
"goodbye": [],
"prompt": [],
"record_max_duration": 0,
"template": "(string)"
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
emails | array | Emails to send the recording to (mp3 attached) |
goodbye | array | Played after accepting the recording. |
prompt | array | Prompt: "1" to listen to the recording, "2" to accept it, "3" to record again. |
record_max_duration | int | Max duration (seconds) 10..120 |
template | string | Email template |
Instant voice response Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye.
{
"broadcast": [],
"keys": {},
"prompt": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "NO"
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
keys | object |
Key configuration Object: Sendr.10.Campaign.Ivr.Voice.IvrKeys |
prompt | array | IVR prompt |
voicemail_broadcast | array | Leave message on voicemail |
voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
IVR key
{
"action": "CALLBACK",
"params": {}
}
Property | Type | Description |
---|---|---|
action | string |
Key action Values: "BRIDGE", "BROADCAST", "CALLBACK", "EMAIL", "NONE", "RECORD" |
params | object |
Key params Objects: Sendr.10.Campaign.Ivr.Voice.Action.Broadcast, Sendr.10.Campaign.Ivr.Voice.Action.Bridge, Sendr.10.Campaign.Ivr.Voice.Action.Email, Sendr.10.Campaign.Ivr.Voice.Action.Callback, Sendr.10.Campaign.Ivr.Voice.Action.Record |
IVR keys
{
"key_0": {},
"key_1": {},
"key_2": {},
"key_3": {},
"key_4": {},
"key_5": {},
"key_6": {},
"key_7": {},
"key_8": {},
"key_9": {}
}
Property | Type | Description |
---|---|---|
key_0 | object |
Key '0' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_1 | object |
Key '1' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_2 | object |
Key '2' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_3 | object |
Key '3' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_4 | object |
Key '4' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_5 | object |
Key '5' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_6 | object |
Key '6' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_7 | object |
Key '7' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_8 | object |
Key '8' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
key_9 | object |
Key '9' Object: Sendr.10.Campaign.Ivr.Voice.IvrKey |
Simple voice broadcasting. Messages are played in the following order: voicemail_detect_media, broadcast, prompt, goodbye.
{
"broadcast": [],
"goodbye": [],
"prompt": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "DIRECT"
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
goodbye | array | Played after the prompt |
prompt | array | Prompt to listen the broadcast again (key "1") |
voicemail_broadcast | array | Leave message on voicemail |
voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
Voice survey
{
"broadcast": [],
"goodbye": [],
"key_error": [],
"key_valid": [],
"questions": [],
"voicemail_broadcast": [],
"voicemail_detect_media": [],
"voicemail_detect_method": "DIRECT"
}
Property | Type | Description |
---|---|---|
broadcast | array | Broadcast messages |
goodbye | array | Goodbye messages |
key_error | array | Played when an invalid key is pressed, or when no key is pressed |
key_valid | array | Played when key is valid |
questions | array |
Survey questions Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Question |
voicemail_broadcast | array | Leave message on voicemail |
voicemail_detect_media | array | Media played for the "DTMF" method (should ask to press a key) |
voicemail_detect_method | string |
Voicemail detection method Values: "AUTO", "DIRECT", "DTMF", "NO" |
Survey answer
{
"broadcast": "(string)",
"key": "(string)",
"text": "(string)"
}
Property | Type | Description |
---|---|---|
broadcast | string | Answer (media) |
key | string | Key assigned to the answer |
text | string | Answer (text) |
Survey question
{
"answers": [],
"broadcast": [],
"text": "(string)"
}
Property | Type | Description |
---|---|---|
answers | array |
Answers Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Answer |
broadcast | array | Question (media) |
text | string | Question (text) |
Auto-stop conditions
{
"enabled": true,
"per_answer_count": {},
"per_key": {}
}
Property | Type | Description |
---|---|---|
enabled | bool | Enable auto-stop? |
per_answer_count | object |
Stop on specific number of answered calls Object: Sendr.10.Campaign.Options.AutoStopConditions.PerAnswerCount |
per_key | object |
Stop when count of specific keys are pressed Object: Sendr.10.Campaign.Options.AutoStopConditions.PerKey |
Auto-stop conditions: per-answer count
{
"count": 0,
"enabled": true
}
Property | Type | Description |
---|---|---|
count | int | Target number of answered calls |
enabled | bool | Enable? |
Auto-stop conditions: per-key count
{
"enabled": true,
"key_0": 0,
"key_1": 0,
"key_2": 0,
"key_3": 0,
"key_4": 0,
"key_5": 0,
"key_6": 0,
"key_7": 0,
"key_8": 0,
"key_9": 0
}
Property | Type | Description |
---|---|---|
enabled | bool | Enable? |
key_0 | int | Target number of key '0' press |
key_1 | int | Target number of key '1' press |
key_2 | int | Target number of key '2' press |
key_3 | int | Target number of key '3' press |
key_4 | int | Target number of key '4' press |
key_5 | int | Target number of key '5' press |
key_6 | int | Target number of key '6' press |
key_7 | int | Target number of key '7' press |
key_8 | int | Target number of key '8' press |
key_9 | int | Target number of key '9' press |
Followup options
{
"actions": {},
"conditions": {},
"enabled": true
}
Property | Type | Description |
---|---|---|
actions | object |
Followup actions Object: Sendr.10.Campaign.Options.Followup.Actions |
conditions | object |
Followup conditions Object: Sendr.10.Campaign.Options.Followup.Conditions |
enabled | bool | Enable followup actions? |
Followup actions
{
"callback": {},
"sms": {}
}
Property | Type | Description |
---|---|---|
callback | object |
Callback actions Object: Sendr.10.Campaign.Options.Followup.Actions.Callback |
sms | object |
SMS actions Object: Sendr.10.Campaign.Options.Followup.Actions.Sms |
Followup actions (callback)
{
"count": 0,
"delay_minutes": 0,
"enabled": true
}
Property | Type | Description |
---|---|---|
count | int | How many times should we call back? 1..5 |
delay_minutes | int | Delay (minutes) between call back. 5..240 |
enabled | bool | Enabled? |
Followup actions (SMS)
{
"enabled": true,
"sender": "(string)",
"text": "(string)"
}
Property | Type | Description |
---|---|---|
enabled | bool | Enabled? |
sender | string |
Sms sender Format: sms_sender (a-zA-Z0-9, space, dash, underscore - must contain at least one alpha character) |
text | string | Sms text |
Followup conditions
{
"no_response": true,
"short_call": true,
"short_call_duration": 0,
"voicemail_detected": true
}
Property | Type | Description |
---|---|---|
no_response | bool | Condition: no response or busy |
short_call | bool | Condition: short call |
short_call_duration | int | Short call duration in seconds (1..60) |
voicemail_detected | bool | Condition: voicemail detected |
Report sending campaign options
{
"emails": [],
"enabled": true,
"phones": []
}
Property | Type | Description |
---|---|---|
emails | array | Emails to send report to |
enabled | bool | Send report? |
phones | array | Phones (SMS) to send report to |
SMS options
{
"nature": "ALERTING",
"send_report": {}
}
Property | Type | Description |
---|---|---|
nature | string |
Campaign nature Values: "ALERTING", "MARKETING" |
send_report | object |
Report sending Object: Sendr.10.Campaign.Options.SendReport |
Voice options
{
"auto_stop": {},
"call_recording": true,
"ccl": 0,
"cli": "(string)",
"followup": {},
"nature": "MARKETING",
"send_report": {}
}
Property | Type | Description |
---|---|---|
auto_stop | object |
Auto stop conditions Object: Sendr.10.Campaign.Options.AutoStopConditions |
call_recording | bool | Activate call recording (ONLY WHEN BRIDGING) |
ccl | int | Concurrent call limit |
cli | string |
Calling line identification Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
followup | object |
Followup actions Object: Sendr.10.Campaign.Options.Followup |
nature | string |
Campaign nature Values: "ALERTING", "MARKETING" |
send_report | object |
Report sending Object: Sendr.10.Campaign.Options.SendReport |
Search filters
{
"hash": "(string)",
"keywords": "(string)",
"name": "(string)"
}
Property | Type | Description |
---|---|---|
hash | string | ID filter |
keywords | string | Keywords |
name | string | Name filter |
Campaign status
{
"counters": {},
"ended_at": "2021-04-24 00:42:42",
"finished_cause": "SYSTEM",
"finished_cause_data": {},
"items_done": 0,
"items_total": 0,
"items_total_t": 0,
"percent": 0,
"started_at": "2021-04-24 00:42:42",
"state": "STOPPED"
}
Property | Type | Description |
---|---|---|
counters | object |
Counters Objects: Sendr.10.Campaign.Status.SmsSimple, Sendr.10.Campaign.Status.SmsSurvey, Sendr.10.Campaign.Status.VoiceSimple, Sendr.10.Campaign.Status.VoiceIvr, Sendr.10.Campaign.Status.VoiceSurvey |
ended_at | string |
Ended time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
finished_cause | string |
Finished cause Values: "AUTOSTOP", "DONE", "NONE", "STOPPED", "SYSTEM" |
finished_cause_data | object | More information about the cause |
items_done | int | Number of phone numbers that have been processed and for which all possible followup actions have been exhausted |
items_total | int | Number of phone numbers to call (initially - in the addressbook) |
items_total_t | int | Number of phone numbers with retries (this can change if there are "retries") |
percent | int | Percent completion 0..100 |
started_at | string |
Start time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
state | string |
State Values: "CREATED", "FINISHED", "PAUSED", "STARTED", "STOPPED" |
SMS Sent Statuses Number of SMS per status.
{
"ERROR": 0,
"EXPIRED": 0,
"FAILED": 0,
"PENDING": 0,
"RECEIVED": 0,
"REMOTE_QUEUED": 0,
"SENT": 0,
"UNKNOWN": 0
}
Property | Type | Description |
---|---|---|
ERROR | int | Number of SMS in error |
EXPIRED | int | Number of SMS that expired |
FAILED | int | Number of SMS that failed to reach |
PENDING | int | Number of SMS yet pending |
RECEIVED | int | Number of SMS recieved |
REMOTE_QUEUED | int | Number of SMS currently queuded within a remote carrier system |
SENT | int | Number of SMS sent |
UNKNOWN | int | Number of SMS with an unknown status |
Simple SMS campaign report status
{
"answers": 0,
"answers_unique": 0,
"billed": "(string)",
"cost": "(string)",
"errors": 0,
"optouts": 0,
"sent": 0,
"sent_status": {}
}
Property | Type | Description |
---|---|---|
answers | int | Number of answers |
answers_unique | int | Number of unique answers |
billed | string | Amount billed |
cost | string | Mean cost per SMS in cents |
errors | int | Number of SMS that failed |
optouts | int | Number of optouts |
sent | int | Number of SMS sent |
sent_status | object |
Number of SMS per sent status Object: Sendr.10.Campaign.Status.Sms.SentStatus |
Survey SMS campaign report status
{
"answers": 0,
"billed": "(string)",
"cost": "(string)",
"errors": 0,
"optouts": 0,
"questions": [],
"sent": 0
}
Property | Type | Description |
---|---|---|
answers | int | Number of answers |
billed | string | Amount billed |
cost | string | Mean cost per SMS in cents |
errors | int | Number of SMS that failed |
optouts | int | Number of optouts |
questions | array | Array containign the questions in the survey and the answers. |
sent | int | Number of SMS sent |
Voice campaign call statuses
{
"ABSENT/BUSY": 0,
"ABSENT/NO_ANSWER": 0,
"ABSENT/VOICEMAIL_DETECTED": 0,
"ANSWERED/COMPLETE": 0,
"ANSWERED/INCOMPLETE": 0,
"ERROR/BLACKLISTED": 0,
"ERROR/OTHER": 0,
"ERROR/REJECTED": 0,
"ERROR/UNALLOCATED_NUMBER": 0
}
Property | Type | Description |
---|---|---|
ABSENT/BUSY | int | Number of unanswered calls because destination is busy |
ABSENT/NO_ANSWER | int | Number of unanswered calls |
ABSENT/VOICEMAIL_DETECTED | int | Number of unanswered calls with a voicemail detected |
ANSWERED/COMPLETE | int | Number of answered and completed calls |
ANSWERED/INCOMPLETE | int | Number of answered but incomplete calls |
ERROR/BLACKLISTED | int | Number of calls not made because number is blacklisted |
ERROR/OTHER | int | Number of calls with another unknown error |
ERROR/REJECTED | int | Number of calls that were rejected |
ERROR/UNALLOCATED_NUMBER | int | Numbers that are unallocated |
Voice campaign status per key pressed
{
"key_0": 0,
"key_1": 0,
"key_2": 0,
"key_3": 0,
"key_4": 0,
"key_5": 0,
"key_6": 0,
"key_7": 0,
"key_8": 0,
"key_9": 0
}
Property | Type | Description |
---|---|---|
key_0 | int | Number of times key '0' was pressed |
key_1 | int | Number of times key '1' was pressed |
key_2 | int | Number of times key '2' was pressed |
key_3 | int | Number of times key '3' was pressed |
key_4 | int | Number of times key '4' was pressed |
key_5 | int | Number of times key '5' was pressed |
key_6 | int | Number of times key '6' was pressed |
key_7 | int | Number of times key '7' was pressed |
key_8 | int | Number of times key '8' was pressed |
key_9 | int | Number of times key '9' was pressed |
Voice campaign retries
{
"cause": {},
"count": 0,
"sms_sent": 0
}
Property | Type | Description |
---|---|---|
cause | object |
Object containing number of retries per cause Object: Sendr.10.Campaign.Status.Voice.Retries.Causes |
count | int | Number of retries |
sms_sent | int | Number of SMS sent as part of a retry condition |
Voice campaign retries causes
{
"CALLBACK": 0,
"NO_RESPONSE": 0,
"SHORTCALL": 0,
"VOICEMAIL_DETECTED": 0
}
Property | Type | Description |
---|---|---|
CALLBACK | int | Number of retries because the user asked for a callback |
NO_RESPONSE | int | Number of retries because no response |
SHORTCALL | int | Number of retries because the call was hung up too fast |
VOICEMAIL_DETECTED | int | Number of retries because a voicemail was detected |
Voice IVR campaign status
{
"acd": 0,
"actions": {},
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"optouts": 0,
"retries": {}
}
Property | Type | Description |
---|---|---|
acd | int | Average call duration |
actions | object |
Object containing status on actions per key pressed Object: Sendr.10.Campaign.Ivr.Voice.IvrKeys |
call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
calls | int | Number of calls |
calls_active | int | Number of of active calls |
calls_answered | int | Number of answered calls |
cost | string | Mean cost per call in cents |
optouts | int | Number of optouts |
retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Simple Voice campaign status
{
"acd": 0,
"broadcast": {},
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"keys": {},
"optouts": 0,
"retries": {}
}
Property | Type | Description |
---|---|---|
acd | int | Average call duration |
broadcast | object |
Object containing details and history on calls. Object: Sendr.10.Campaign.Status.VoiceSimple.Broadcast |
call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
calls | int | Number of calls |
calls_active | int | Number of of active calls |
calls_answered | int | Number of answered calls |
cost | string | Mean cost per call in cents |
keys | object |
Number of optouts Object: Sendr.10.Campaign.Status.Voice.Keys |
optouts | int | Number of optouts |
retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Simple Voice campaign report brodcast status info
{
"completed": 0,
"history": {}
}
Property | Type | Description |
---|---|---|
completed | int | Number of calls completed |
history | object | Object with date-based properties indicating the number of calls for each date |
Voice survey campaign status
{
"acd": 0,
"call_status": {},
"calls": 0,
"calls_active": 0,
"calls_answered": 0,
"cost": "(string)",
"keys": {},
"optouts": 0,
"questions": [],
"retries": {}
}
Property | Type | Description |
---|---|---|
acd | int | Average call duration |
call_status | object |
Object containing the number of calls per status Object: Sendr.10.Campaign.Status.Voice.CallStatus |
calls | int | Number of calls |
calls_active | int | Number of of active calls |
calls_answered | int | Number of answered calls |
cost | string | Mean cost per call in cents |
keys | object |
Number of optouts Object: Sendr.10.Campaign.Status.Voice.Keys |
optouts | int | Number of optouts |
questions | array |
Survey questions Array of objects: Sendr.10.Campaign.Ivr.Voice.Survey.Question |
retries | object |
Object containing information on retries if applicable Object: Sendr.10.Campaign.Status.Voice.Retries |
Test call
{
"call_answered_at": "2021-04-24 00:42:42",
"call_duration": 0,
"call_hangup_at": "2021-04-24 00:42:42",
"call_started_at": "2021-04-24 00:42:42",
"call_status": "PENDING",
"id": 0,
"number": "+447890123456"
}
Property | Type | Description |
---|---|---|
call_answered_at | string |
Call answer time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
call_duration | int | Call duration (secs) |
call_hangup_at | string |
Call hangup time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
call_started_at | string |
Call start time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
call_status | string |
Call status Values: "ANSWERED", "DIALING", "HANGUP", "PENDING", "PROCESSING" |
id | int | Call id |
number | string |
Phone number Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
Sendr campaign report
{
"campaign": {},
"created_at": "2021-04-24 00:42:42",
"data": {},
"hash": "UNIQUEID",
"state": "FINAL",
"updated_at": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
campaign | object |
The campaign object when the report was generated Object: Sendr.10.Campaign |
created_at | string |
Creation time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
data | object |
Report data Objects: Sendr.10.Campaign.Status.VoiceSimple, Sendr.10.Campaign.Status.VoiceSurvey, Sendr.10.Campaign.Status.VoiceIvr, Sendr.10.Campaign.Status.SmsSimple, Sendr.10.Campaign.Status.SmsSurvey |
hash | string |
Report ID Format: hash (Unique object identifier) |
state | string |
Report state Values: "FINAL", "INTERIM" |
updated_at | string |
Update time Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
Search filters
{
"created_at_from": "2021-04-24 00:42:42",
"created_at_to": "2021-04-24 00:42:42",
"name": "(string)",
"type": "(string)",
"updated_at_from": "2021-04-24 00:42:42",
"updated_at_to": "2021-04-24 00:42:42"
}
Property | Type | Description |
---|---|---|
created_at_from | string |
Created at from Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
created_at_to | string |
Created at to Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
name | string | Campaign name |
type | string | Campaign type : SMS_SIMPLE, SMS_SURVEY, VOICE_SIMPLE, VOICE_SURVEY, VOICE_IVR |
updated_at_from | string |
Updated at from Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
updated_at_to | string |
Updated at to Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
SIP Subscriber
{
"cli": "(string)",
"codecs": [],
"domain": "(string)",
"id": 0,
"password": "(string)",
"privacy": "full",
"ring_timeout": 0,
"srtp": true,
"username": "(string)",
"vms": {}
}
Property | Type | Description |
---|---|---|
cli | string |
Calling Line Identification. Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
codecs | array |
Codecs Values: "G729", "OPUS", "PCMA", "PCMU" |
domain | string | Domain (auto-filled) |
id | int | SIP Subscriber ID |
password | string | Password (auto-generated) |
privacy | string |
Privacy Values: "full", "off" |
ring_timeout | int |
Ring timeout in seconds Format: ring_timeout (Must be between 5 and 120 seconds) |
srtp | bool | Set to true to enable SRTP on inbound calls |
username | string |
Username Format: sip_subscriber_username (SIP Subscriber username) |
vms | object |
Voicemail Params Object: App.Param.Vms |
SIP Subscriber Options
{
"vms": {}
}
Property | Type | Description |
---|---|---|
vms | object |
Voicemail Params Object: App.Param.Vms |
SIP Subscriber Properties
{
"cli": "(string)",
"codecs": [],
"privacy": "off",
"ring_timeout": 0,
"srtp": true,
"username": "(string)"
}
Property | Type | Description |
---|---|---|
cli | string |
Calling Line Identification (optional, default: "BLOCKED"). Can be "BLOCKED", any DID you have on your account, or any phone number we have authorized on your account. Format: cli_phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", "+33678912345" or "BLOCKED") |
codecs | array |
Codecs (optional, default: empty) Values: "G729", "OPUS", "PCMA", "PCMU" |
privacy | string |
Privacy (optional, default: "full" ie. Presentation prohibited (Anonymous call)) Values: "full", "off" |
ring_timeout | int |
Ring timeout in seconds (optional, default: 30) Format: ring_timeout (Must be between 5 and 120 seconds) |
srtp | bool | Set to true to enable SRTP on inbound calls |
username | string |
Username (optional, default: auto-generated) Format: sip_subscriber_username (SIP Subscriber username) |
SIP Subscriber Search filters
{
"domain": "(string)",
"username": "(string)"
}
Property | Type | Description |
---|---|---|
domain | string | Domain |
username | string |
Username Format: sip_subscriber_username (SIP Subscriber username) |
SIP Trunk Origination
{
"id": 0
}
Property | Type | Description |
---|---|---|
id | int | SIP Trunk Origination ID |
SIP Trunk Origination Options
{
}
Property | Type | Description |
---|
SIP Trunk Origination Properties
{
}
Property | Type | Description |
---|
SIP Trunk Origination Search filters
{
}
Property | Type | Description |
---|
SIP Trunk Termination
{
"id": 0
}
Property | Type | Description |
---|---|---|
id | int | SIP Trunk Termination ID |
SIP Trunk Termination Options
{
}
Property | Type | Description |
---|
SIP Trunk Termination Properties
{
}
Property | Type | Description |
---|
SIP Trunk Termination Search filters
{
}
Property | Type | Description |
---|
SMS text message
{
"b_customer_debit": "0.00",
"b_customer_mode": "POSTPAID",
"date_creation": "2021-04-24 00:42:42",
"date_received": "2021-04-24 00:42:42",
"date_sent": "2021-04-24 00:42:42",
"date_update": "2021-04-24 00:42:42",
"encoding": "UNICODE",
"from": "(string)",
"hash": "UNIQUEID",
"nature": "MARKETING",
"options": {},
"parts": 0,
"status": "EXPIRED",
"status_error": "(string)",
"text": "(string)",
"to": "(string)",
"type": "OUT",
"user_data": "(string)"
}
Property | Type | Description |
---|---|---|
b_customer_debit | string |
Amount debited Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
b_customer_mode | string |
Billing mode Values: "POSTPAID", "PREPAID" |
date_creation | string |
Date of creation Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_received | string |
Received date (if received) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_sent | string |
Sent date (if sent) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
date_update | string |
Date of last update (status update) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
encoding | string |
The encoding used to send the SMS Values: "GSM", "UNICODE" |
from | string | Sender |
hash | string |
SMS ID Format: hash (Unique object identifier) |
nature | string |
SMS Nature Values: "ALERTING", "MARKETING" |
options | object |
SMS options Object: SMS.Options |
parts | int | Number of SMS parts billed. May be > 1 if your text is too long. |
status | string |
SMS status Values: "CREATED", "ERROR", "EXPIRED", "FAILED", "PENDING", "RECEIVED", "REMOTE_QUEUED", "SENT" |
status_error | string | Descriptive error if status is "ERROR" |
text | string | SMS content |
to | string | Recipient |
type | string |
SMS type Values: "IN", "OUT" |
user_data | string |
Custom field set in $options Format: cdr_customer_field (32 alphanumeric characters maximum) |
The SMS.Options object defines the following properties.
{
"flash_message": true,
"force_encoding": "UNICODE",
"nature": "ALERTING",
"user_data": "(string)",
"webhook": {}
}
Property | Type | Description |
---|---|---|
flash_message | bool | Send the SMS as a Flash Message (text will be shown on phone but not stored - not supported by all carriers and phone) |
force_encoding | string |
Force the encoding to be used. It is generally a good idea to force GSM because it is working everywhere on every carrier. Default is NULL (auto-detect). Values: "GSM", "UNICODE" |
nature | string |
SMS Nature. Make sure to select the right nature, otherwise your account might be blocked. Values: "ALERTING", "MARKETING" |
user_data | string |
Custom field sent back you Format: cdr_customer_field (32 alphanumeric characters maximum) |
webhook | object |
Dynamic webhook for this SMS. Status updates will be set to this specific webhook (and also to your "sms.mt.status_update" subscriptions). Replies to this SMS will also be sent to this specific webhook. You only need to set 'endpoint' and optionally 'options'. Object: Webhook |
Quote for a SMS
{
"amount": "0.00",
"count": 0,
"currency": "USD",
"encoding": "UNICODE",
"length": 0
}
Property | Type | Description |
---|---|---|
amount | string |
The amount this SMS will cost Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
count | int | Number of SMS billed |
currency | string |
The currency of the cost. This is always the same, depending on your account. Values: "EUR", "USD" |
encoding | string |
Charset that will be used Values: "GSM", "UNICODE" |
length | int | Text length (number of characters) |
Search filters
{
"created_at_from": "2021-04-24 00:42:42",
"created_at_to": "2021-04-24 00:42:42",
"from": "+16469820800",
"hash": "UNIQUEID",
"nature": "ALERTING",
"status": "PENDING",
"text": "(string)",
"to": "+447890123456",
"type": "OUT"
}
Property | Type | Description |
---|---|---|
created_at_from | string |
Retrieve from this date (max. NOW minus 6 months) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
created_at_to | string |
Retrieve until this date (inclusive) Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
from | string |
Sender Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
hash | string |
SMS Hash Format: hash (Unique object identifier) |
nature | string |
SMS nature Values: "ALERTING", "MARKETING" |
status | string |
SMS status Values: "CREATED", "ERROR", "EXPIRED", "FAILED", "PENDING", "RECEIVED", "REMOTE_QUEUED", "SENT" |
text | string | SMS content |
to | string |
Recipient Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
type | string |
SMS type Values: "IN", "OUT" |
Sub Account
{
"account": {},
"contact": {},
"credentials": {},
"params": {},
"state": {}
}
Property | Type | Description |
---|---|---|
account | object |
The Sub Account account informations Object: SubAccount.Account |
contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
credentials | object |
The Sub Account credentials informations Object: SubAccount.Credentials |
params | object |
The Sub Account params informations Object: SubAccount.Params |
state | object |
The Sub Account state informations Object: SubAccount.State |
Sub Account Account
{
"company": "(string)",
"firstname": "(string)",
"lastname": "(string)"
}
Property | Type | Description |
---|---|---|
company | string |
The account company Format: field_name (Generic name field) |
firstname | string |
The account firstname Format: field_name (Generic name field) |
lastname | string |
The account lastname Format: field_name (Generic name field) |
Sub Account Contact
{
"addresses": [],
"emails": [],
"phones": [],
"tech_emails": []
}
Property | Type | Description |
---|---|---|
addresses | array |
The contact addresses (min:0, max :1) Array of objects: Address |
emails | array |
The contact emails (min:1, max :1) Format: email (An email address) |
phones | array |
The contact phones (min:0, max :1) Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
tech_emails | array |
The technical contact emails Format: email (An email address) |
Sub Account Creation Options
{
"password": {}
}
Property | Type | Description |
---|---|---|
password | object |
The password creation options Object: SubAccount.CreateOptions.Password |
Sub Account Creation Options Password
{
"method": "AUTO",
"value": "(string)"
}
Property | Type | Description |
---|---|---|
method | string |
The password creation method Values: "AUTO", "MANUAL" |
value | string |
The password value in MANUAL method Format: subaccount_password_value (Sub Account password) |
Sub Account Params Creation
{
"billing": {}
}
Property | Type | Description |
---|---|---|
billing | object |
The Sub Account billing params informations Object: SubAccount.CreateParams.Billing |
Sub Account Params Billing Creation
{
"addresses": [],
"emails": []
}
Property | Type | Description |
---|---|---|
addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Creation Properties
{
"account": {},
"contact": {},
"params": {}
}
Property | Type | Description |
---|---|---|
account | object |
The Sub Account account informations Object: SubAccount.Account |
contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
params | object |
The Sub Account params informations Object: SubAccount.CreateParams |
Sub Account Credentials
{
"login": "(string)",
"password": "(string)"
}
Property | Type | Description |
---|---|---|
login | string | The login |
password | string | The password (print only the first time) |
Sub Account Edition Options
{
}
Property | Type | Description |
---|
Sub Account Params Editable
{
"billing": {}
}
Property | Type | Description |
---|---|---|
billing | object |
The Sub Account billing params informations Object: SubAccount.EditParams.Billing |
Sub Account Params Billing Editable
{
"addresses": [],
"emails": []
}
Property | Type | Description |
---|---|---|
addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Edition Properties
{
"contact": {},
"params": {}
}
Property | Type | Description |
---|---|---|
contact | object |
The Sub Account contact informations Object: SubAccount.Contact |
params | object |
The Sub Account params informations Object: SubAccount.EditParams |
Sub Account Params
{
"billing": {},
"default": {}
}
Property | Type | Description |
---|---|---|
billing | object |
The Sub Account billing params informations Object: SubAccount.Params.Billing |
default | object |
The Sub Account default params informations Object: SubAccount.Params.Default |
Sub Account Params Billing
{
"addresses": [],
"currency_code": "EUR",
"emails": []
}
Property | Type | Description |
---|---|---|
addresses | array |
The billing addresses (min:0, max :1) Array of objects: Address |
currency_code | string |
The billing currency Values: "EUR", "USD" |
emails | array |
The billing emails (min:0) Format: email (An email address) |
Sub Account Params Default
{
"locale": "(string)",
"timezone": "(string)"
}
Property | Type | Description |
---|---|---|
locale | string |
The sub account locale Format: locale (POSIX/IANA locale code. Example: "en_US" or "fr_FR".) |
timezone | string |
The sub account timezone Format: timezone_str (IANA timezone name. Example: "Europe/Paris".) |
Sub Account Quota
{
"actual": 0,
"max": 0
}
Property | Type | Description |
---|---|---|
actual | int | The number of Sub Accounts used |
max | int | The maximum number of Sub Accounts allowed |
Sub Account Search filters
{
"archived": true
}
Property | Type | Description |
---|---|---|
archived | bool | FALSE: only not archived, TRUE: only archived, NULL: both (Default: FALSE) |
Sub Account State
{
"allow_calls_in": true,
"allow_calls_out": true,
"allow_sms_in": true,
"allow_sms_out": true,
"archived": true,
"credit": "0.00",
"disabled": true
}
Property | Type | Description |
---|---|---|
allow_calls_in | bool | Are inbound calls allowed? |
allow_calls_out | bool | Are outbound calls allowed? |
allow_sms_in | bool | Are inbound SMS allowed? |
allow_sms_out | bool | Are outbound SMS allowed? |
archived | bool | The archived state |
credit | string |
The sub account credit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
disabled | bool | The disabled state |
Sub Account Tranfer Options
{
}
Property | Type | Description |
---|
Target (Phone number + timeout)
{
"number": "+16469820800",
"timeout": 30
}
Property | Type | Description |
---|---|---|
number | string |
The phone number to dial Format: phone_number (International E.164 format "+CCNSN". Example: "+16467890800", "+447890123456", or "+33678912345") |
timeout | int |
Ringing timeout in seconds. Must be between 5 and 300 Format: dial_timeout (Must be between 5 and 300 seconds) |
Realtime App. Allows you to control the call in Real-Time. WARNING: DEPRECATED by REALTIME10.
{
"data_format": "JSON",
"login": "(string)",
"password": "(string)",
"url": "(string)"
}
Property | Type | Description |
---|---|---|
data_format | string |
Data format. The only format supported right now is "JSON" Values: "JSON" |
login | string | Login if your URL is password protected (HTTP Basic Authentication) |
password | string | Password If your URL is password protected (HTTP Basic Authentication) |
url | string | Your URL callback. Our system will POST call status to your URL, and your answers will control the call |
Timezone object
{
"country_codes": [],
"dst": "(string)",
"iana": "(string)",
"iana_names": [],
"id": 0,
"label": "(string)"
}
Property | Type | Description |
---|---|---|
country_codes | array |
Countries in this timezone Format: country_code (ISO 3166-1 alpha-2 country code. Example: "US") |
dst | string | Indicate if the timezone is subject to Daylight Saving Time |
iana | string | IANA timezone name |
iana_names | array | IANA timezone aliases |
id | int | Timezone ID |
label | string | Timezone name |
Object pushed to a your callback URL. Deprecated. See webhooks!
{
"data": {},
"datetime": "2021-04-24 00:42:42",
"try": 0,
"type": "CONFERENCE10_EVENT"
}
Property | Type | Description |
---|---|---|
data | object |
Push data Object: CONFERENCE10.Event |
datetime | string |
Datetime related to the data pushed. Format: datetime (YYYY-MM-DD HH:MM:SS in UTC timezone. Example: "2012-04-24 23:42:00") |
try | int | Push try count. Starts at 1. Will try up to 10 times until the callback URL replies with a HTTP 2XX result code. |
type | string |
Push type. Values: "CONFERENCE10_EVENT" |
Webhook object
{
"created_at": "2021-04-24 00:42:42.123",
"endpoint": "(string)",
"hash": "UNIQUEID",
"options": {},
"status": "DISABLED_SYSTEM",
"type": "(string)",
"updated_at": "2021-04-24 00:42:42.123"
}
Property | Type | Description |
---|---|---|
created_at | string |
Date of creation Format: datetime_ms (YYYY-MM-DD HH:MM:SS.sss in UTC timezone. Example: "2012-04-24 23:42:00.123") |
endpoint | string |
Endpoint URL Format: url (HTTP(S) URL) |
hash | string |
Unique ID Format: hash (Unique object identifier) |
options | object |
Options Object: Webhook.Options |
status | string |
Status Values: "DISABLED", "DISABLED_ADMIN", "DISABLED_SYSTEM", "ENABLED" |
type | string | Hook type |
updated_at | string |
Date of update Format: datetime_ms (YYYY-MM-DD HH:MM:SS.sss in UTC timezone. Example: "2012-04-24 23:42:00.123") |
Webhook event object
{
"data": {},
"event_at": "2021-04-24T00:42:42.123Z",
"event_id": "(string)",
"hook_hash": "UNIQUEID",
"try": 0,
"type": "(string)"
}
Property | Type | Description |
---|---|---|
data | object | Webhook data |
event_at | string |
Event time Format: datetime_ms_iso (YYYY-MM-DDTHH:MM:SS.sssZ in UTC timezone. Example: "2012-04-24T23:42:00.123Z" or "2012-04-24T23:42:00.123+00:00") |
event_id | string | Unique event ID |
hook_hash | string |
Webhook ID. Can be NULL if dynamic Webhook. Format: hash (Unique object identifier) |
try | int | Push try number. Starts at 0. If push fails (you did not reply in time, or 200 < response code > 299), we try again and increment try. |
type | string | Webhook type |
Webhook Credit event
{
"balance": "0.00",
"currency_code": "(string)",
"last_transaction_amount": "0.00",
"shutdown_limit": "0.00",
"warning_limit": "0.00"
}
Property | Type | Description |
---|---|---|
balance | string |
Current balance Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
currency_code | string | Currency code of your account ("EUR", "USD", etc.) |
last_transaction_amount | string |
Amount of last transaction Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
shutdown_limit | string |
Shutdown limit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
warning_limit | string |
Warning limit Format: amount (amount in cents with 2 decimals. Example : "1000.00" for 10 USD or EUR) |
Webhook log search filters
{
"endpoint": "(string)",
"event_date": "(string)",
"event_id": "(string)",
"hook_hash": "(string)",
"http_code": "(string)",
"status": "(string)",
"try": 0,
"type": "(string)"
}
Property | Type | Description |
---|---|---|
endpoint | string | Search by endpoint |
event_date | string | Search by event date |
event_id | string | Search by event id |
hook_hash | string | Search by hook id |
http_code | string | Search by http code |
status | string | Search by status |
try | int | Search by try number 0..9 |
type | string | Search by hook type |
Webhook options
{
"format": "(string)",
"hmac_algo": "MD5",
"hmac_secret": "(string)"
}
Property | Type | Description |
---|---|---|
format | string | Webhook format: "JSON" only for now. |
hmac_algo | string |
Algorithm used for HMAC signature Values: "MD5", "SHA1", "SHA256", "SHA512" |
hmac_secret | string | Secret used for HMAC signature. Length: 8..1024. |