DialMyCalls API Documentation (version 2.0)

Overview

Request

Authentication

Every DialMyCalls account has a unique API key, which can be found here under API Info.

All API requests require authentication via HTTP basic auth. To achieve this the API key must be passed into the endpoint URL in the following format: https://{ApiKey}@api.dialmycalls.com/.

Request Headers

Header Description
Content-Type Use the Content-Type header to indicate the incoming data format. We currently support application/json and application/xml.
Accept This header tells us what format to return the data in. We currently support application/json and application/xml. The default response is JSON.
Range This header is used for pagination of results. The required format for this header is records=1-100. The maximum number of records that can be requested by a single API call is 100.

Custom Data Types

Name Type Description
timestamp string Date/time in ISO 8601 format.
uuid string Uuid in 8-4-4-4-12 format.

Methods

Method Usage
DELETE Used for destroying existing resources
GET Used for retrieving lists and individual resources
POST Used for creating new resources
PUT Used for updating existing resources

Response

Possible Status Codes

Code Description
200 OK The request was successful.
201 CREATED The request was successful; we created a new resource and the response body contains the object.
206 PARTIAL CONTENT The request was successful; a paged list of resources were returned.
400 BAD REQUEST The data given in the POST or PUT failed validation. Inspect the response body for details.
401 UNAUTHORIZED The supplied credentials, if any, are not sufficient to delete the resource.
402 PAYMENT REQUIRED Your account does not have enough credits to perform the requested action.
404 NOT FOUND The resource was not found.
500 SERVER ERROR There was an internal server error.

Request ID

Each API response contains a unique request id in the to facilitate tracking. When reporting issues, providing this value makes it easier to pinpoint problems and provide solutions more quickly.

Sample Responses

Successful
{
    "results": {
        "id": "fcc43bd7-ccc4-490a-960f-69d00610ca59",
        "firstname": "John",
        "lastname": "Doe",
        "phone": "5555555555",
        "extension": "123",
        "email": "example@domain.com",
        "extra1": "Lorem ipsum dolor sit amet...",
        "groups": [
            {
                "id": "dece446c-29ce-405c-a967-4eed720f8835"
            }
        ],
        "created_at": "2014-07-17T21:26:40+0000",
        "updated_at": "2014-07-17T21:48:20+0000"
    },
    "meta": {
        "result": "success",
        "status": 200,
        "request_id": "a1f3b257-7eca-4d61-a83c-38c428e96bfb"
    }
}
Error
{
    "results": {
        "error": {
            "message": "This resource does not exist."
        }
    },
    "meta": {
        "result": "failure",
        "status": 404,
        "request_id": "8c48624f-78e4-49e7-a43f-8cf90ac421a9"
    }
}

Libraries

You may download and install our PHP SDK from GitHub.


Methods

Get Account

GET  https://{ApiKey}@api.dialmycalls.com/2.0/account

Retrieve account details.

Response

Returns a account object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve your account information
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/account

Add Caller ID

POST  https://{ApiKey}@api.dialmycalls.com/2.0/callerid

Add a caller ID.

Request

Name Description Type Required
phone The caller ID phone number. string yes
name The caller ID's name. string yes

Response

Returns a caller ID object on success, and returns an error otherwise.

Examples

How to add a caller ID
curl -i -H "Content-Type: application/json" -X POST -d "{\"phone\": \"5555555555\", \"name\": \"New Number\"}" https://$API_KEY@api.dialmycalls.com/2.0/callerid

Add Caller ID (Unverified)

POST  https://{ApiKey}@api.dialmycalls.com/2.0/verify/callerid

Initiate adding a new caller ID when you need to go through the verification process. You will receive a phone call at the phone number provided and will need to make a subsequent API call with the PIN code that you are provided.

Request

Name Description Type Required
phone The caller ID phone number. string yes
name The caller ID's name. string yes

Response

Returns a caller ID object on success, and returns an error otherwise.

Examples

How to add a caller ID when needing additional verification
curl -i -H "Content-Type: application/json" -X POST -d "{\"phone\": \"5555555555\", \"name\": \"New Number\"}" https://$API_KEY@api.dialmycalls.com/2.0/verify/callerid

Verify Caller ID

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/verify/callerid/{CalleridId}

Verify a new caller ID.

Request

Name Description Type Required
pin Verification PIN number received from making add caller ID request. string yes

Response

Returns a caller ID object if a valid identifier was provided, and returns an error otherwise.

Examples

Verify a caller ID
curl -i -H "Content-Type: application/json" -X POST -d "{\"phone\": \"5555555555\", \"name\": \"New Number\"}" https://$API_KEY@api.dialmycalls.com/2.0/verify/callerid/$CALLERID_ID

Get Caller ID

GET  https://{ApiKey}@api.dialmycalls.com/2.0/callerid/{CalleridId}

Retrieve a caller ID.

Response

Returns a caller ID object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a caller ID
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/callerid/$CALLERID_ID

Update Caller ID

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/callerid/{CalleridId}

Update an existing caller ID.

Request

Name Description Type Required
name The caller ID's name. string yes

Response

Returns a caller ID object if a valid identifier was provided and input validation passed, and returns an error otherwise.

Examples

How to update a caller ID
curl -i -H "Content-Type: application/json" -X PUT -d "{\"name\": \"New Number Updated\"}" https://$API_KEY@api.dialmycalls.com/2.0/callerid/$CALLERID_ID

Delete Caller ID

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/callerid/{CalleridId}

Delete a caller ID.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this caller ID. uuid

Examples

How to delete a caller ID
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/callerid/$CALLERID_ID

List Caller IDs

GET  https://{ApiKey}@api.dialmycalls.com/2.0/callerids

Retrieve a list of caller IDs.

Response

Returns a list of caller ID objects.

Examples

How to retrieve a list of caller IDs
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/callerids

Create Call

POST  https://{ApiKey}@api.dialmycalls.com/2.0/service/call

Create an outgoing call broadcast.

Request

Name Description Type Required
name Name the broadcast. string yes
callerid_id The caller id that the message should be sent from. uuid yes
recording_id The routing id of the message that should be played. uuid yes
send_at When the broadcast should be sent. timestamp no
send_immediately Should the broadcast go out immediately? boolean no
use_amd Using answering machine detection? boolean no
send_email Also send an email to the contacts? boolean no
accessaccount_id Schedule this broadcast as an access account. uuid no
contacts List of contact information that should be sent the broadcast.

Contact Attributes

Name Description Type Required
phone Contact's phone number. string yes
firstname Contact's first name. string no
lastname Contact's last name. string no
email Contact's email address. string no
list yes
add_ons A list of feature add-ons for the calls.

Push To Record

Name Description Type Required
type The add-on type. Option: record string yes
add_message Add a generic add-on message.
Name Description Type Required
gender Options: M, F string yes
message Option: record string yes
object no

Push To Talk

Name Description Type Required
type The add-on type. Option: ptt string yes
callerid_id Phone number to connect the caller to. uuid yes
ringtone The ringtone to play to the user when connecting. Options: elevator_music, caribbean_music, classical_music, digital_ringing, old_phone_ringing, goofy_music string no
cpm Calls per minute throttling. integer no
add_message Add a generic add-on message.
Name Description Type Required
gender Options: M, F string yes
message Options: pttmessage, pttmessage2, pttmessage3 string yes
object no

Polling

Name Description Type Required
type The add-on type. Option: polling string yes
options A list of polling options. list yes
add_message Add a generic add-on message.
Name Description Type Required
gender Options: M, F string yes
message Option: polling string yes
object no

Push To Opt-Out

Name Description Type Required
type The add-on type. Option: optout string yes
add_message Add a generic add-on message.
Name Description Type Required
when Options: beginning, end string yes
gender Options: M, F string yes
message Option: optnotreceive string yes
object no

Push To Listen Again

Name Description Type Required
type The add-on type. Option: listen string yes
add_message Add a generic add-on message.
Name Description Type Required
gender Options: M, F string yes
message Option: repeat string yes
object no
list no

Response

Returns a service object on success, and returns an error otherwise.


Get Call

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/call/{CallId}

Retrieve a call.

Response

Returns a service object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a call
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/call/$CALL_ID

Cancel Call

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/service/call/{CallId}

Cancel an outgoing call.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this call. uuid

Examples

How to cancel an outgoing call
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/service/call/$CALL_ID

Get Call Recipients

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/call/{CallId}/recipients

Retrieve a list of a call's recipients.

Response

Returns a list of call recipient objects if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a list of a call's recipients
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/call/$CALL_ID/recipients

List Calls

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/calls

Retrieve a list of calls.

Response

Returns a list of service objects.

Examples

How to retrieve a list of calls
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/calls

Add Contact

POST  https://{ApiKey}@api.dialmycalls.com/2.0/contact

Add a contact to your contact list.

Request

Name Description Type Required
firstname The contact's first name. string no
lastname The contact's last name. string no
phone The contact's phone number. string yes
extension The contact's phone extension. string no
email The contact's email address. string no
extra1 Miscellaneous data about this contact. string no
groups List of group IDs that this contact should belong to. list no

Response

Returns a contact object on success, and returns an error otherwise.

Examples

How to add a contact
curl -i -H "Content-Type: application/json" -X POST -d "{\"phone\": \"5555555555\"}" https://$API_KEY@api.dialmycalls.com/2.0/contact

Get Contact

GET  https://{ApiKey}@api.dialmycalls.com/2.0/contact/{ContactId}

Retrieve a contact to your contact list.

Response

Returns a contact object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a contact
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/contact/$CONTACT_ID

Update Contact

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/contact/{ContactId}

Update an existing contact in your contact list.

Request

Name Description Type Required
firstname The contact's first name. string no
lastname The contact's last name. string no
phone The contact's phone number. string yes
extension The contact's phone extension. string no
email The contact's email address. string no
extra1 Miscellaneous data about this contact. string no
groups List of group IDs that this contact should belong to. list no

Response

Returns a contact object if a valid identifier was provided and input validation passed, and returns an error otherwise.

Examples

How to update a contact
curl -i -H "Content-Type: application/json" -X PUT -d "{\"phone\": \"5555555555\"}" https://$API_KEY@api.dialmycalls.com/2.0/contact/$CONTACT_ID

Delete Contact

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/contact/{ContactId}

Delete a contact from your contact list.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this contact. uuid

Examples

How to delete a contact
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/contact/$CONTACT_ID

List Contacts

GET  https://{ApiKey}@api.dialmycalls.com/2.0/contacts

Retrieve a list of contacts.

Response

Returns a list of contact objects.

Examples

How to retrieve a list of contacts
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/contacts

List Contacts in Group

GET  https://{ApiKey}@api.dialmycalls.com/2.0/contacts/{GroupId}

Retrieve a list of contacts in a contact group.

Response

Returns a list of contact objects.

Examples

How to retrieve a list of contacts for a contact group
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/contacts/$GROUP_ID

Add Group

POST  https://{ApiKey}@api.dialmycalls.com/2.0/group

Add a contact group.

Request

Name Description Type Required
name The contact group's name. string yes

Response

Returns a group object on success, and returns an error otherwise.

Examples

How to add a contact group
curl -i -H "Content-Type: application/json" -X POST -d "{\"name\": \"Test Group\"}" https://$API_KEY@api.dialmycalls.com/2.0/group

Get Group

GET  https://{ApiKey}@api.dialmycalls.com/2.0/group/{GroupId}

Retrieve a contact group.

Response

Returns a group object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a contact group
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/group/$GROUP_ID

Update Group

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/group/{GroupId}

Update an existing contact group.

Request

Name Description Type Required
name The contact group's name. string yes

Response

Returns a group object if a valid identifier was provided and input validation passed, and returns an error otherwise.

Examples

How to update a contact group
curl -i -H "Content-Type: application/json" -X PUT -d "{\"name\": \"Test Group Updated\"}" https://$API_KEY@api.dialmycalls.com/2.0/group/$GROUP_ID

Delete Group

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/group/{GroupId}

Delete a contact group.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this contact group. uuid

Examples

How to delete a contact group
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/group/$GROUP_ID

List Groups

GET  https://{ApiKey}@api.dialmycalls.com/2.0/groups

Retrieve a list of contact groups.

Response

Returns a list of group objects.

Examples

How to retrieve a list of contact groups
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/groups

Get Keyword

GET  https://{ApiKey}@api.dialmycalls.com/2.0/keyword/{KeywordId}

Retrieve a keyword.

Response

Returns a keyword object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a keyword
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/keyword/$KEYWORD_ID

Delete Keyword

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/keyword/{KeywordId}

Delete a keyword.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this keyword ID. uuid

Examples

How to delete a keyword
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/keyword/$KEYWORD_ID

List Keywords

GET  https://{ApiKey}@api.dialmycalls.com/2.0/keywords

Retrieve a list of keywords.

Response

Returns a list of keyword objects.

Examples

How to retrieve a list of keywords
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/keywords

Create Recording (Text-to-Speech)

POST  https://{ApiKey}@api.dialmycalls.com/2.0/recording/tts

Create a new recording using text-to-speech.

Request

Name Description Type Required
name The name of the recording. string yes
gender Gender of the recording. Options: M or F string yes
language The language of the recording. Options: en string yes
text The text to convert to speech. string yes

Response

Returns a recording object on success, and returns an error otherwise.

Examples

How to create a recording using text-to-speech
curl -i -H "Content-Type: application/json" -X POST -d "{\"name\": \"Test Recording\", \"gender\": \"M\", \"language\": \"en\", \"text\": \"This is just a test.\"}" https://$API_KEY@api.dialmycalls.com/2.0/recording/tts

Create Recording (URL)

POST  https://{ApiKey}@api.dialmycalls.com/2.0/recording/url

Create a new recording from a URL.

Request

Name Description Type Required
name The name of the recording. string yes
url The URL of the sound file. (Formats: MP3 or WAV) string yes

Response

Returns a recording object on success, and returns an error otherwise.

Examples

How to create a recording from the URL of a sound file
curl -i -H "Content-Type: application/json" -X POST -d "{\"name\": \"Test Recording\", \"url\": \"https://ia700200.us.archive.org/1/items/testmp3testfile/mpthreetest.mp3\"}" https://$API_KEY@api.dialmycalls.com/2.0/recording/url

Create Recording (Phone)

POST  https://{ApiKey}@api.dialmycalls.com/2.0/recording/phone

Create a new recording by phone.

Request

Name Description Type Required
name The name of the recording. string yes
callerid_id The caller id that the create recording message should be sent from. uuid yes
phone The recipient's phone number who will record the message. string yes

Response

Returns a recording object on success, and returns an error otherwise.

Examples

How to create a recording from the URL of a sound file
curl -i -H "Content-Type: application/json" -X POST -d "{\"name\": \"Test Recording\", \"phone\": \"5551234567\", \"callerid_id\": \"$CALLERID_ID\"}" https://$API_KEY@api.dialmycalls.com/2.0/recording/phone

Get Recording

GET  https://{ApiKey}@api.dialmycalls.com/2.0/recording/{RecordingId}

Retrieve a recording.

Response

Returns a recording object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a recording
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/recording/$RECORDING_ID

Update Recording

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/recording/{RecordingId}

Update an existing recording.

Request

Name Description Type Required
name The recording's name. string yes

Response

Returns a recording object if a valid identifier was provided and input validation passed, and returns an error otherwise.

Examples

How to update a recording
curl -i -H "Content-Type: application/json" -X PUT -d "{\"name\": \"Test Recording Updated\"}" https://$API_KEY@api.dialmycalls.com/2.0/recording/$RECORDING_ID

Delete Recording

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/recording/{RecordingId}

Delete a recording.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this recording. uuid

Examples

How to delete a recording
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/recording/$RECORDING_ID

List Recordings

GET  https://{ApiKey}@api.dialmycalls.com/2.0/recordings

Retrieve a list of recordings.

Response

Returns a list of recording objects.

Examples

How to retrieve a list of recordings
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/recordings

Create Text

POST  https://{ApiKey}@api.dialmycalls.com/2.0/service/text

Create an outgoing text broadcast.

Request

Name Description Type Required
name Name the broadcast. string yes
keyword_id The keyword id that should be associated with this broadcast. uuid yes
messages List of messages to send (up to 2). list yes
send_at When the broadcast should be sent. timestamp no
send_immediately Should the broadcast go out immediately? boolean no
send_email Also send an email to the contacts? boolean no
accessaccount_id Schedule this broadcast as an access account. uuid no
contacts List of contact information that should be sent the broadcast.

Contact Attributes

Name Description Type Required
phone Contact's phone number. string yes
firstname Contact's first name. string no
lastname Contact's last name. string no
email Contact's email address. string no
list yes

Response

Returns a service object on success, and returns an error otherwise.


Get Text

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/text/{TextId}

Retrieve a text.

Response

Returns a service object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a text
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/text/$TEXT_ID

Cancel Text

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/service/text/{TextId}

Cancel an outgoing text.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this text. uuid

Examples

How to cancel an outgoing text
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/service/text/$TEXT_ID

Get Text Recipients

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/text/{TextId}/recipients

Retrieve a list of a text's recipients.

Response

Returns a list of text recipient objects if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a list of an text's recipients
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/text/$TEXT_ID/recipients

List Texts

GET  https://{ApiKey}@api.dialmycalls.com/2.0/service/texts

Retrieve a list of texts.

Response

Returns a list of service objects.

Examples

How to retrieve a list of texts
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/service/texts

Get Vanity Number

GET  https://{ApiKey}@api.dialmycalls.com/2.0/vanitynumber/{VanityNumberId}

Retrieve a vanity number.

Response

Returns a vanitynumber object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve a vanity number
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/vanitynumber/$VANITYNUMBER_ID

Delete Vanity Number

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/vanitynumber/{VanityNumberId}

Delete a vanity number.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this vanity number ID. uuid

Examples

How to delete a vanitynumber
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/keyword/$VANITYNUMBER_ID

List Vanity Numbers

GET  https://{ApiKey}@api.dialmycalls.com/2.0/vanitynumbers

Retrieve a list of vanity numbers.

Response

Returns a list of vanitynumber objects.

Examples

How to retrieve a list of vanity numbers
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/vanitynumbers

Add Access Account

POST  https://{ApiKey}@api.dialmycalls.com/2.0/accessaccount

Add a access account.

Request

Name Description Type Required
email The email address for this access account. string yes
password The password for this access account. Requirements: 8 characters, 1 digit, 1 upper case character. string yes
name The name for this access account. string yes

Response

Returns a access account object on success, and returns an error otherwise.

Examples

How to add a access account
curl -i -H "Content-Type: application/json" -X POST -d "{\"email\": \"test@test.com\", \"password\": \"1234A5678\", \"name\": \"John Doe\"}" https://$API_KEY@api.dialmycalls.com/2.0/accessaccount

Get Access Account

GET  https://{ApiKey}@api.dialmycalls.com/2.0/accessaccount/{AccessAccountId}

Retrieve an access account.

Response

Returns a access account object if a valid identifier was provided, and returns an error otherwise.

Examples

How to retrieve an access account
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/accessaccount/$ACCESSACCOUNT_ID

Update Access Account

PUT  https://{ApiKey}@api.dialmycalls.com/2.0/accessaccount/{AccessAccountId}

Update an existing access account.

Request

Name Description Type Required
email The email address for this access account. string no
password The password for this access account. Requirements: 8 characters, 1 digit, 1 upper case character. string no
name The name for this access account. string no

Response

Returns a access account object if a valid identifier was provided and input validation passed, and returns an error otherwise.

Examples

How to update a access account
curl -i -H "Content-Type: application/json" -X PUT -d "{\"name\": \"New Name\"}" https://$API_KEY@api.dialmycalls.com/2.0/accessaccount/$ACCESSACCOUNT_ID

Delete Access Account

DELETE  https://{ApiKey}@api.dialmycalls.com/2.0/accessaccount/{AccessAccountId}

Delete a access account.

Response

Returns the following if a valid identifier was provided, and returns an error otherwise.

Name Description Type
id Unique identifier for this access account. uuid

Examples

How to delete an access account
curl -i -H "Content-Type: application/json" -X DELETE https://$API_KEY@api.dialmycalls.com/2.0/accessaccount/$ACCESSACCOUNT_ID

List Access Accounts

GET  https://{ApiKey}@api.dialmycalls.com/2.0/accessaccounts

Retrieve a list of access accounts.

Response

Returns a list of access account objects.

Examples

How to retrieve a list of access accounts
curl -i -H "Content-Type: application/json" -X GET https://$API_KEY@api.dialmycalls.com/2.0/accessaccounts

Objects

Account

This object represents your account information.

Attributes

Name Description Type
credits_available The amount of credits available on your account. float
created_at When your account was created. timestamp

Caller ID

This object represents a phone number that can be used as the caller ID when placing a call.

Attributes

Name Description Type
id Unique identifier for this caller ID. uuid
name The name of the caller ID. string
phone The caller ID phone number. string
approved Whether this caller ID is approved for use. boolean
created_at When the caller id was created. timestamp
updated_at When the caller id was last updated. timestamp

Access Account

This object represents an access account that can be used as a sub-account.

Attributes

Name Description Type
id Unique identifier for this access account. uuid
name The name of the access account. string
email The access account email address. string
created_at When the access account was created. timestamp
updated_at When the access account was last updated. timestamp

Call Recipient

This object represents the recipient of a call.

Attributes

Name Description Type
firstname The recipient's first name. string
lastname The recipient's last name. string
email The recipient's email address. string
phone The recipient's phone number. string
extension The recipient's phone extension. string
status Status of the call. Options: live_answer, vm, busy, no_answer, dialing, not_connected, queued string
duration Duration of the call in seconds. integer
add_on Result from add-on feature.
Name Description Type
type The type of add-on we received the result for. string
result The add-on result. string
list
attempts Number of attempts to call was made. string
successful Whether the call was successful or not. boolean
called_at When the recipient was contacted. timestamp

Contact

This object represents a contact that exists on the DialMyCalls.com platform.

Attributes

Name Description Type
id Unique identifier for this contact. uuid
firstname The contact's first name. string
lastname The contact's last name. string
phone The contact's phone number. string
extension The contact's phone extension. string
email The contact's email address. string
extra1 Miscellaneous data about this contact. string
groups List of groups that this contact belongs to.
Name Description Type
id Unique identifier for this group. uuid
list
created_at When the contact was created. timestamp
updated_at When the contact was last updated. timestamp

Group

This object represents a contact group that exists on the DialMyCalls.com platform.

Attributes

Name Description Type
id Unique identifier for this group. uuid
name The group name. string
created_at When the group was created. timestamp
updated_at When the group was last updated. timestamp

Keyword

This object represents a keyword that exists on the DialMyCalls.com platform.

Attributes

Name Description Type
id Unique identifier for this group. uuid
keyword The keyword. string
status The status of the keyword. Options: active, pendingdelete, onhold, billingdecline string
created_at When the keyword was created. timestamp
updated_at When the keyword was last updated. timestamp

Recording

This object represents a recording that can be used for placing calls.

Attributes

Name Description Type
id Unique identifier for this recording. uuid
name The recording name. string
type The recording type. Options: text or sound string
seconds The length of the recording. integer
url The URL of the recording file. string
processed Whether the recording is ready for use. boolean
created_at When the recording was created. timestamp
updated_at When the recording was last updated. timestamp

Service

This object represents a service call/email/text.

Attributes

Name Description Type
id Unique identifier for this service. uuid
accessaccount_id Unique identifier for the access account which initiated this if available. uuid
name The name of the service. string
pending_cancel Whether the service has been flagged to be cancelled. boolean
credit_cost The amount of credits required to schedule this service. float
send_at When the service will be sent. timestamp
created_at When the service was created. timestamp
updated_at When the service was last updated. timestamp

Text Recipient

This object represents the recipient of a text.

Attributes

Name Description Type
firstname The recipient's first name. string
lastname The recipient's last name. string
email The recipient's email address. string
phone The recipient's phone number. string
status Status of the text. Options: delivered, undeliverable, enroute, unknown, non_mobile, queued string
successful Whether the text was successful or not. boolean

Vanity Number

This object represents a vanity number that exists on the DialMyCalls.com platform.

Attributes

Name Description Type
id Unique identifier for this group. uuid
phone The phone number. string
status The status of the vanity number. Options: active, onhold, billingdecline, pendingdelete string
minutes_used The amount of minutes used since last billing. float
minutes_allowed The amount of minutes included with the vanity number before billed additionally. float
voicemails_new The amount of voicemails that have not been downloaded. integer
voicemails_old The amount of voicemails that have been downloaded. integer
created_at When the keyword was created. timestamp
updated_at When the keyword was last updated. timestamp

Powered by Olark