Telmetrics V3 API Developer Documentation

Welcome to the Telmetrics V3 developer hub. You'll find comprehensive guides and documentation to help you start working with our API as quickly as possible.

Get Started    

Notification Files

When configuring a Tracking Number, you have the option to add Call Features. Most call features require an audio message to be played to the caller or advertiser.

Using our text to speech capabilities, Telmetrics can automatically generate the audio notification for you, however in cases where you want more control over the notification, you may choose to manage them yourself.

Retrieving Notification Files

Notification files are categorized by their type, the following API end-points can be used to retrieve them. Using the 'stype' URL parameter, you can filter the results for your request to only return notification files relevant to their call feature:

Using the following request will return all notification files that can be used with the Call Record feature:

 curl -H "x-organization-token: {authorization_token}" \
     -X GET \

If successful, a response similar to the following will be returned

        "data_store_id": "104dad62-b2a0-4a9d-9c8c-056cf236f2b1",
        "type": "CallRecordFiles",
        "file_name": "Thankyouforcalling.wav",
        "created_datetime": "2011-04-02T08:29:08.463"
        "data_store_id": "4e8a8a1a-b6ee-48dc-85ed-05bbb3fa0dff",
        "type": "CallRecordFiles",
        "file_name": "synth-78-636586218103565469.wav",
        "created_datetime": "2018-04-06T14:30:10.777"
        "data_store_id": "3d832e61-1856-4576-a487-08d985b0c2a1",
        "type": "CallRecordFiles",
        "file_name": "qualityassurance.wav",
        "created_datetime": "2018-03-07T15:58:38.883"

Uploading a Notification File

Notification files can be uploaded by submitting a POST request to:

When submitting a request, you will need to specify the 'stype' parameter, and the name of the MP3 file containing the audio notification file. Use the following to create a notification file:


Using the following request will create a notification file:

curl -H "x-organization-token: {authentication_token}" \
-F "file=@callRecordNotification.mp3;type=audio/mpeg"

If successful, a response similar to the following will be generated:

    "data_store_id": "784ba69d-86df-44d8-b656-85efefce6511",
    "type": "CallRecordFiles",
    "file_name": "callRecordNotification.mp3",
    "created_datetime": "2018-04-17T13:39:55.7299023Z"

Notification Files

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.