{"info":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","description":"

This is the official API documentation for Tall Bob.

Below you will find a current list of the available endpoints for use with the Tall Bob API. You will need a Tall Bob account and valid API credentials in order to use the API. These will be different in each available environment (Sandbox/Production) and can be managed within the appropriate Tall Bob settings page, depending on which environment you are in.

for Sandbox accounts, go to https://app-test.tallbob.com
\n
for Production accounts, go to https://app.tallbob.com
\n

From the settings menu on the top right, select API Credentials to manage them.

Click on the link to know more about the differences between the Sandbox and Production Environment

Base URLs

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Base URL	Purpose
https://api-test.tallbob.com/v2	Sandbox for Testing
https://api.tallbob.com/v2	Production

It should be noted that all the endpoints and examples used in this document (and associated Postman Collection) have been hard-coded to be using the Sandbox Base URL.

Authentication

Basic HTTP authentication should be used in the header:

username - your API username
\n
password - your API key
\n

Please ensure that you are mapping the correct credentials when connecting to the relevant environment. If not you'll receive an authentication error

For a detailed guide on getting API Credentials, click here

Please ensure you keep your Production API key a secret - if it is compromised for any reason, simply generate a new one and ensure you have updated your API clients to use your updated credentials. Instructions for creating Basic Auth headers can be found here

Required Headers

Apart from the above authentication header, you will also need include the following when making API calls:

Content-type = application/json

SMS Message Lengths

A standard SMS message has a maximum of 160 characters. Unicode SMS messages are messages which contain characters not found in the standard GSM 03.38 character set - these have a maximum of 70 characters.

Longer messages are possible, however please be aware that exceeding these limits constitutes an \"additional\" SMS. Such messages are then split into what is called a \"multi-part\" message. Your recipient(s) will still see the message as one single, long message on their handset - but behind the scenes it has been split into these \"multi-part\" message segments, and billed accordingly.

Opt-out tags

You are required to add an opt-out message to the end of your message body if you are sending what would be considered a marketing message. This opt-out message can include the tag {OptOutURL} which is a placeholder that will add a link that can be clicked to opt-out. Please be aware that expanding this tag into an actual link will increase the character count of your message - potentially turning your message into a multi-part message.

The standard length of an {OptOutURL} tag is 13 characters

There is a hard limit of 1570 characters in total, for your message.

Using a Sender ID

Alphanumeric \"sender IDs\" are used for one-way, branded messaging. Instead of using an E.164 formatted Tall Bob phone number, you can use a custom string value to match branding used by your business.

Note: alphanumeric sender IDs are not available everywhere - when using them, please ensure you are sending to phone numbers in countries which support this feature.

Alphanumeric sender IDs can be up to 11 characters and must include at least one letter and the following:

upper-case letters A-Z
\n
lower-case letters a-z
\n
numbers 0-9
\n
.#&!-
\n
spaces
\n

Any other Non-ASCII special characters and punctuation are not allowed.

Timestamps

All dates and times are returned in the common ISO 8601 format

It is important to note that this includes Timezone information as well - all values are stored in UTC. You can also include optional timestamp parameters to your query, with some endpoints (see below)

Timestamps in Requests

The format of the timestamps you can use in your requests is reasonably flexible... For example, 01/01/1970, 2001-12-31, 2002-10-20T12:26:13+00:00, last Monday and yesterday are all examples of valid inputs for these types of request.

MMS File Types

The following file types are currently acceptable for sending via MMS. Please note the appropriate file extension should be used, in order to identify the file type.

Please note that the maximum file size supported is 1500KB

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

File Extension	File Type
.gif	image/gif
.png	image/png
.jpg, .jpeg	image/jpeg
.mp3	audio/mpeg
.wav	audio/wav
.3gp	audio/3gpp
.mp4	video/mp4
.mpg, .mpeg	video/mpeg
.avi	video/avi
.pdf	application/pdf
.vcf, .vcard	text/vcard
.cal	text/calendar

Pagination

Some endpoints return results which are paginated and you can include optional pagination parameters in your query. By default, the first page of 50 items will be returned. The maximum page size is 1000.

List Requests

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description
page	the page number; defaults to 1
per_page	the number of items that one single page represents; defaults to 50; min 1; max 1000
after	the timestamp that items should start from (inclusive)
before	the timestamp that items should be before (exclusive)

List Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description
total	total number of resources available
item_count	number of resources returned
current_page	current page number
per_page	number of resources returned per page
first_item	number of the first resource in the current page
last_item	number of the last resource in the current page
prev_page_url	a URL of the previous page - `null` if not available
next_page_url	a URL of the next page - `null` if not available
data	the actual resources, in an array

Request Limits

The API currently has a limit of 1MB for any individual request. If you need to send more than this you should split your data so that it can be sent across multiple requests that are no larger than this size.

Http Status Codes

The API will respond with one of the following HTTP status codes:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Status Code	Explanation
OK	200	The request completed successfully (and returned results).
NO CONTENT	204	The server has successfully fulfilled the request and there is no additional content to send in the response payload body.
BAD REQUEST	400	The server cannot or will not process the request due to something that is perceived to be a client error (eg. malformed request syntax or invalid request message framing).
UNAUTHORISED	401	Authentication credentials for the target resource were invalid.
FORBIDDEN	403	The server understood the request but refuses to allow it.
NOT FOUND	404	The requested resource is invalid or does not exist.
METHOD NOT ALLOWED	405	The method received in the request-line is not supported by the target resource.
TOO MANY REQUESTS	429	The user has sent too many requests in a given amount of time (\"rate limiting\").
INTERNAL SERVER ERROR	500	We broke something - please let us know so we can fix it!
SERVICE UNAVAILABLE	503	The server is currently experiencing a temporary overload or scheduled maintenance, which will likely be alleviated after a small delay.
GATEWAY TIMEOUT	504	The server was unable to produce a timely response in order to complete the request.

CORS

If you are building your API client into a web app, you should specify the CORS origins your app will be using.

Postman

Use the button on the top right to download our API collection so you can test with the Postman app. Simply import the collection and create an environment with username and password variables to get started.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Base URLs","slug":"base-urls"},{"content":"Authentication","slug":"authentication"},{"content":"SMS Message Lengths","slug":"sms-message-lengths"},{"content":"Using a Sender ID","slug":"using-a-sender-id"},{"content":"MMS File Types","slug":"mms-file-types"},{"content":"Pagination","slug":"pagination"},{"content":"Request Limits","slug":"request-limits"},{"content":"Http Status Codes","slug":"http-status-codes"}],"owner":"2638524","collectionId":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","publishedId":"UVkiRy3s","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"292A58","highlight":"7F95CC"},"publishDate":"2022-02-17T03:47:44.000Z"},"item":[{"name":"Chat","item":[{"name":"Send Chat SMS","id":"07f98dd2-3f09-4d90-b43b-9175fc9d2ab7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"to","value":"{integer}","description":"

Single mobile number in E.164 format (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

Your Chat message text (required)

\n","type":"text"},{"key":"reference","value":"{string}","description":"

Chat reference for tracking

\n","type":"text"},{"key":"campaign_reference","value":"{string}","description":"

(Optional Field) Used for custom report building

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/chat/send/sms","description":"

To send a single chat SMS, make an HTTP POST to this resource URI and provide us with a to, message and reference for the chat and we will choose a longcode from your pool that the recipient can reply to.

Any additional requests received using the same to and reference will be sent using the same longcode.\nMultiple recipients can use the same reference, but they will not necessarily receive the message from the same longcode.\nUsing multiple references to a single recipient allows the integrator to have multiple chat threads occurring on the end users device.

Required Parameters

When creating a new message via the API, you must include a to parameter. This value should be a single recipient phone number in E.164 format.

You must also include a message parameter containing the message's content. If this value exceeds a certain length it is regarded as a \"multi-part\" message.

Finally, you need to include a reference parameter, which you can use for your own internal tracking, as a transaction reference, when matching up against webhooks you have set up.

OPT-OUT tags

If your message contains the {OptOutURL} string, the length and price returned will reflect the expansion of this tag into an actual, proper URL - which could potentially turn your message into a multi-part message, with more than one segment.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Starting a conversation with an end user has never been easier.

By using our endpoint we take care of the sender address for you so that your messages will be received in the same thread on a users device.

For detailed information regarding this endpoint, please refer to our support documentation here

Before starting:

At this time, only +61 (Australia) longcodes and recipients are supported.
\n
You will need to contact support or your account manager to have a 'pool' of longcodes assigned to your account for your chat messages.
\n

Chat messages are considered to be of a transactional nature, and therefore any unsubscribe/optout statuses of your recipients are not checked.

\n
It is your responsibility to conform to SPAM messaging rules and regulations.
\n

Receiving replies

Receiving replies to your messages is handled by our webhook system, specifically the 'message_received' event. You will want to have set this endpoint up either within the platform, or via the webhook API endpoints. The mobile, message and reference will all be included in the payload so that you can map it to the message that was sent.

For further enrichment of your chat system, we also recommend setting up a listener for the 'message_delivered' event so you know when messages have been successfully delivered.

To further aid you during the development on our test system, you will be able to create incoming messages to fire your webhooks using this endpoint.

\n","_postman_id":"93613ae1-5dba-4ede-8337-9d2390044c42","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Contacts","item":[{"name":"Create New Contact","id":"dd495e56-f8ac-465b-8be4-6c251928dc20","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"first_name\": \"{{firstname}}\",\n \"last_name\": \"{{lastname}}\",\n \"external_id\": \"{{externalID}}\", \n \"mobile\": null\n}\n"},"url":"https://api.tallbob.com/v2/contacts","description":"

Post data to create a new contact with details provided. Upon successful creation, details of your new contact will be returned - including the Tall Bob Contact ID, which is used by other methods, including sending an SMS Campaign.

Required Parameters

Every request must contain a first_name value, representing the contact's first name, and a value for their mobile number - in E.164 format. Neither parameter can contain an empty value.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

You can delete a contact using this endpoint. If your contact was also part of a group, it will automatically be removed from the group as well.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

Your unique ID, which has been saved as the \"external ID\" of the contact (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/find","description":"

If you do not know the Tall Bob Contact ID for your contact but you had set the \"external ID\" for the contact to your own unique ID, you can use that unique ID to find the contact, using this endpoint. In case your external ID contains special characters which may not translate correctly, if used as a query parameter, this is passed in the body of a POST.

Required Parameters

exernal_id - this is a unique ID which is shared between your system and ours, allowing you to match your contacts with Tall Bob contacts, using a common identifier.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

List of contacts for your account, by request. You can send a request and retrieve your contact list at a time that suits you, using this endpoint.

Optional filtering

You can also filter results by email address and mobile number, by passing these in as (optional) query parameters.

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter results by email address

\n","type":"text/plain"},"key":"email","value":"{email_address}"},{"description":{"content":"

Filter results by mobile number

\n","type":"text/plain"},"key":"mobile","value":"{mobile_number}"}],"variable":[]}},"response":[{"id":"8fb7696e-0bd0-4e8f-812a-960b18439d6d","name":"By Email ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/contacts/?email=example.com","host":["https://api.tallbob.com"],"path":["v2","contacts",""],"query":[{"key":"email","value":"example.com","description":"Filter results by email address"},{"key":"mobile","value":"61411","description":"Filter results by mobile number","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Feb 2020 04:27:55 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 19,\n \"item_count\": 4,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 4,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"627aa15c-4c83-11ea-9ca1-067453a7f748\",\n \"first_name\": \"Cassandra\",\n \"last_name\": \"Botsford\",\n \"mobile\": \"61456172149\",\n \"email\": \"uwolf@example.com\",\n \"external_id\": \"ad065bcf-1833-3b7b-b6cd-10b99484a552\",\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d3891c0-daa9-11e9-8d21-029c13ef7f22\",\n \"first_name\": \"Lucy\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118793\",\n \"email\": \"test1@example.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b376-daa9-11e9-86e4-029c13ef7f22\",\n \"first_name\": \"Joe\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118794\",\n \"email\": \"test2@example.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b894-daa9-11e9-855f-029c13ef7f22\",\n \"first_name\": \"Frank\",\n \"last_name\": \"Smith\",\n \"mobile\": \"61411118795\",\n \"email\": \"test3@example.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n }\n ]\n}"},{"id":"fd6e349b-1ffe-4907-9a17-9af2dddb8ffa","name":"By Mobile","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/contacts/?mobile=61411","host":["https://api.tallbob.com"],"path":["v2","contacts",""],"query":[{"key":"email","value":"{email_address}","description":"Filter results by email address","disabled":true},{"key":"mobile","value":"61411","description":"Filter results by mobile number"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Feb 2020 04:25:30 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1898"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 19,\n \"item_count\": 10,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 10,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"8d3891c0-daa9-11e9-8d21-029c13ef7f22\",\n \"first_name\": \"Lucy\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118793\",\n \"email\": \"test1@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b376-daa9-11e9-86e4-029c13ef7f22\",\n \"first_name\": \"Joe\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118794\",\n \"email\": \"test2@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b894-daa9-11e9-855f-029c13ef7f22\",\n \"first_name\": \"Frank\",\n \"last_name\": \"Smith\",\n \"mobile\": \"61411118795\",\n \"email\": \"test3@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38bd44-daa9-11e9-8eee-029c13ef7f22\",\n \"first_name\": \"Dweezil\",\n \"last_name\": \"Walker\",\n \"mobile\": \"61411118796\",\n \"email\": \"test4@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38c212-daa9-11e9-b50e-029c13ef7f22\",\n \"first_name\": \"Shannon\",\n \"last_name\": \"Jackson\",\n \"mobile\": \"61411118797\",\n \"email\": \"test5@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38c690-daa9-11e9-91cd-029c13ef7f22\",\n \"first_name\": \"Barbara\",\n \"last_name\": \"Bach\",\n \"mobile\": \"61411118798\",\n \"email\": \"test6@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38caf0-daa9-11e9-a482-029c13ef7f22\",\n \"first_name\": \"Susan\",\n \"last_name\": \"Collins\",\n \"mobile\": \"61411118799\",\n \"email\": \"test7@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38cf50-daa9-11e9-89da-029c13ef7f22\",\n \"first_name\": \"Francis\",\n \"last_name\": \"Walker\",\n \"mobile\": \"61411118800\",\n \"email\": \"test8@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38d3a6-daa9-11e9-a986-029c13ef7f22\",\n \"first_name\": \"Bob\",\n \"last_name\": \"Smith\",\n \"mobile\": \"61411118801\",\n \"email\": \"test9@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38d7fc-daa9-11e9-bbe2-029c13ef7f22\",\n \"first_name\": \"Deborah\",\n \"last_name\": \"Lane\",\n \"mobile\": \"61411118802\",\n \"email\": \"test10@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n }\n ]\n}"},{"id":"b453d6ce-2d25-4a9e-9704-cff305f8555b","name":"Contacts","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/contacts/","host":["https://api.tallbob.com"],"path":["v2","contacts",""],"query":[{"key":"email","value":"{email_address}","description":"Filter results by email address","disabled":true},{"key":"mobile","value":"{mobile_number}","description":"Filter results by mobile number","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Feb 2020 04:15:12 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1898"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 19,\n \"item_count\": 19,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 19,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"16ce335e-db63-11e9-8f69-0617db59baea\",\n \"first_name\": \"Jonbon\",\n \"last_name\": \"Jovi\",\n \"mobile\": \"61405999444\",\n \"email\": \"jonbon@jovi.net\",\n \"external_id\": \"jbj595-Z\",\n \"unsubscribed\": false\n },\n {\n \"id\": \"5c11a5c8ac81c\",\n \"first_name\": \"Fred\",\n \"last_name\": \"Flintstone\",\n \"mobile\": \"6141225467\",\n \"email\": \"fred@flintstone.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"5c736e29e8dc4\",\n \"first_name\": \"Oscar\",\n \"last_name\": \"版权所有\",\n \"mobile\": \"61499444222\",\n \"email\": \"\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"627aa15c-4c83-11ea-9ca1-067453a7f748\",\n \"first_name\": \"Cassandra\",\n \"last_name\": \"Botsford\",\n \"mobile\": \"61456172149\",\n \"email\": \"uwolf@example.com\",\n \"external_id\": \"ad065bcf-1833-3b7b-b6cd-10b99484a552\",\n \"unsubscribed\": false\n },\n {\n \"id\": \"631842bc-db6e-11e9-aa33-0227e6a58070\",\n \"first_name\": \"Bart\",\n \"last_name\": \"Simpson\",\n \"mobile\": \"61422777666\",\n \"email\": \"bart@simpsons.com\",\n \"external_id\": \"BARTMAN\",\n \"unsubscribed\": false\n },\n {\n \"id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"first_name\": \"Test\",\n \"last_name\": \"Testerson\",\n \"mobile\": \"61412345678\",\n \"email\": \"test@testerson.com\",\n \"external_id\": \"abc123\",\n \"unsubscribed\": true\n },\n {\n \"id\": \"8d3891c0-daa9-11e9-8d21-029c13ef7f22\",\n \"first_name\": \"Lucy\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118793\",\n \"email\": \"test1@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b376-daa9-11e9-86e4-029c13ef7f22\",\n \"first_name\": \"Joe\",\n \"last_name\": \"Jones\",\n \"mobile\": \"61411118794\",\n \"email\": \"test2@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38b894-daa9-11e9-855f-029c13ef7f22\",\n \"first_name\": \"Frank\",\n \"last_name\": \"Smith\",\n \"mobile\": \"61411118795\",\n \"email\": \"test3@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38bd44-daa9-11e9-8eee-029c13ef7f22\",\n \"first_name\": \"Dweezil\",\n \"last_name\": \"Walker\",\n \"mobile\": \"61411118796\",\n \"email\": \"test4@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38c212-daa9-11e9-b50e-029c13ef7f22\",\n \"first_name\": \"Shannon\",\n \"last_name\": \"Jackson\",\n \"mobile\": \"61411118797\",\n \"email\": \"test5@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38c690-daa9-11e9-91cd-029c13ef7f22\",\n \"first_name\": \"Barbara\",\n \"last_name\": \"Bach\",\n \"mobile\": \"61411118798\",\n \"email\": \"test6@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38caf0-daa9-11e9-a482-029c13ef7f22\",\n \"first_name\": \"Susan\",\n \"last_name\": \"Collins\",\n \"mobile\": \"61411118799\",\n \"email\": \"test7@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38cf50-daa9-11e9-89da-029c13ef7f22\",\n \"first_name\": \"Francis\",\n \"last_name\": \"Walker\",\n \"mobile\": \"61411118800\",\n \"email\": \"test8@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38d3a6-daa9-11e9-a986-029c13ef7f22\",\n \"first_name\": \"Bob\",\n \"last_name\": \"Smith\",\n \"mobile\": \"61411118801\",\n \"email\": \"test9@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38d7fc-daa9-11e9-bbe2-029c13ef7f22\",\n \"first_name\": \"Deborah\",\n \"last_name\": \"Lane\",\n \"mobile\": \"61411118802\",\n \"email\": \"test10@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38dc52-daa9-11e9-9ef7-029c13ef7f22\",\n \"first_name\": \"Lois\",\n \"last_name\": \"Lane\",\n \"mobile\": \"61455518802\",\n \"email\": \"test11@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38e0a8-daa9-11e9-808f-029c13ef7f22\",\n \"first_name\": \"Smokey\",\n \"last_name\": \"Robinson\",\n \"mobile\": \"61418885502\",\n \"email\": \"test12@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n },\n {\n \"id\": \"8d38e4fe-daa9-11e9-8aab-029c13ef7f22\",\n \"first_name\": \"Jane\",\n \"last_name\": \"Doe\",\n \"mobile\": \"61433336699\",\n \"email\": \"test13@email.com\",\n \"external_id\": null,\n \"unsubscribed\": false\n }\n ]\n}"}],"_postman_id":"10b0e5eb-e181-4ccf-b7b3-3c55972615eb"},{"name":"List Contact Campaigns","id":"aca86559-06d6-409b-a8eb-85125622ede0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/contacts/{contact_id}/campaigns","description":"

Get list of SMS Campaigns sent to a specific contact. You can send a request and retrieve data about SMS campaigns for a contact at a time that suits you, using this endpoint - your Tall Bob Contact ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Your Tall Bob Contact metadata key name (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/{contact_id}/metadata","description":"

You can remove a specific metadata item from a contact, identified by Tall Bob Contact ID, using this endpoint - your Contact ID must be present in the URL path.

Required Parameters

Every request must contain a key parameter to identify which metadata value you wish to delete, by key name.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

First name of contact (max length: 50)

\n","type":"text","disabled":true},{"key":"last_name","value":"{string}","description":"

Last name of contact (max length: 100)

\n","type":"text","disabled":true},{"key":"mobile","value":"{integer}","description":"

Mobile number of contact

\n","type":"text","disabled":true},{"key":"email","value":"{string}","contentType":"","description":"

Email address of contact (max length: 100)

\n","type":"text","disabled":true},{"key":"external_id","value":"{string}","description":"

An \"external\" ID to match your own record for the contact - must be unique (max length: 100)

\n","type":"text","disabled":true},{"key":"unsubscribed","value":"{boolean}","description":"

Whether or not the contact has \"opted-out\" from further communication

\n","type":"text","disabled":true},{"key":"first_name","value":"Test POstMan","type":"text"}]},"url":"https://api.tallbob.com/api-test.tallbob.com/v2/contacts/18925b0c-1ea9-11ed-a82f-06e3c557df26","description":"

You can update a contact's details using this endpoint. Similar rules to the Create method apply, except there are no required parameters.

Opt-out status

You can also use this endpoint to \"opt-out\" (and also \"opt-in\") a contact by using the \"unsubscribed\" parameter in your request, as a boolean. (an integer 0 or 1 should also work).

NOTE!

If you pass in an unsubscribed parameter to your request, this is the ONLY part of the request which will be processed. You cannot combine updating a contact's details and subscription status both into the same request.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

JSON object containing named key/value pairs of contact metadata (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/{contact_id}/metadata","description":"

You can create an unlimited number of additional metadata values against a contact, identified by Tall Bob Contact ID, using this endpoint - your Contact ID must be present in the URL path.

Required Parameters

Every request must contain a metadata parameter - a JSON object, containing any number of key/value pairs of contact metadata. If any metadata keys in your request already had values against them for your contact, they will be overwritten with the new values from your request.

Invalid Key Names

Certain characters cannot be used when defining key names for new contact metadata fields:

In addition, there are certain words considered \"reserved\" by the system, which can never be used to define contact metadata either - these are mostly used elsewhere, such as to identify a contact ID or their subscription status.

unsubscribed
FNAME
LNAME
URL
OptOutURL
KEY
VALUE
ID
firstname
lastname
mobile
email
externalID
aID
uID
uniqueID
createdFrom
CreatedDate_ts (with or without the underscore)
ModifiedDate_ts (with or without the underscore)
DeletedDate_ts (with or without the underscore)

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

Retrieve details about a specific contact, identified by Tall Bob Contact ID using this endpoint - your Contact ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"eeb2945c-36b0-4d7d-9784-fceb2d6ab074","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Contact Lists","item":[{"name":"Add Contact","id":"5e5c3796-6ee7-4ca0-a8ab-476d33ebcc8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"contact_id","value":"{string}","description":"

Your Tall Bob contact ID (required)

\n","type":"text"},{"key":"group_id","value":"{string}","description":"

Your Tall Bob group ID (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/groups/attach","description":"

You can add a contact to your group, using this endpoint.

Required Parameters

Your request must contain both a contact_id parameter, representing your Tall Bob Contact ID and a group_id parameter, representing your Tall Bob Group ID.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

Name of group (required if external ID not present - truncated at 255 chars)

\n","type":"text","disabled":true},{"key":"external_id","value":"{string}}","description":"

An \"external\" ID used to match against your own records - must be unique (required if name not present, max length: 100)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/groups","description":"

Create a new contact group with details provided. Upon successful creation, details of your new group will be returned - including the Tall Bob Group ID, which is used by other methods, including sending an SMS Campaign.

Required Parameters

Your request must contain at least a name (representing the group's name) or external_id parameter. Both can be included. As with contacts, external IDs can be used as a common unique identifier between your system and ours.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

You can delete a group using this endpoint - your Tall Bob Group ID must be present in the URL path. If your group had any contacts added to it, they will automatically be removed from the group as well.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

Get list of groups for your account, by request. You can send a request and retrieve your contact group list at a time that suits you, using this endpoint.

Optional filtering

You can also filter results by group name, by passing in a name value as an (optional) query parameter.

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter results by group name

\n","type":"text/plain"},"key":"name","value":"{group_name}"}],"variable":[]}},"response":[{"id":"33ab1c22-3678-4e86-a9b0-2e610455e64f","name":"By Name","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/contacts/groups?name=electric","host":["https://api.tallbob.com"],"path":["v2","contacts","groups"],"query":[{"key":"name","value":"electric","description":"Filter results by group name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Feb 2020 23:40:36 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1896"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 4,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"a8795362-4d26-11ea-affd-067453a7f748\",\n \"name\": \"Electric Boogaloo\",\n \"external_id\": \"BREAKIN-2\",\n \"membership\": 0\n }\n ]\n}"},{"id":"36a9851b-ab3b-4f05-93ee-06a21bdd6b9c","name":"Contact Lists","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/contacts/groups","host":["https://api.tallbob.com"],"path":["v2","contacts","groups"],"query":[{"key":"name","value":"electric","description":"Filter results by group name","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 11 Feb 2020 23:40:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1897"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 4,\n \"item_count\": 4,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 4,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"04b86f32-29c9-11e9-bbe2-02aa10802064\",\n \"name\": \"Group Name\",\n \"external_id\": null,\n \"membership\": 0\n },\n {\n \"id\": \"504a640e-2a8d-11e9-b727-02aa10802064\",\n \"name\": \"groovy group\",\n \"external_id\": \"kebabalab\",\n \"membership\": 3\n },\n {\n \"id\": \"a8795362-4d26-11ea-affd-067453a7f748\",\n \"name\": \"Electric Boogaloo\",\n \"external_id\": \"BREAKIN-2\",\n \"membership\": 0\n },\n {\n \"id\": \"c94e13c4-e567-11e9-87a0-0617db59baea\",\n \"name\": \"unique_test_Resend_2019-10-03\",\n \"external_id\": null,\n \"membership\": 1\n }\n ]\n}"}],"_postman_id":"75201d85-9694-4e8e-9bd1-b7f94009aec3"},{"name":"List Members","id":"a2edc15a-16d3-4ebb-b462-7a68a75e53d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/contacts/groups/{group_id}/members","description":"

List the contacts in a specific group. You can send a request and retrieve data about group members at a time that suits you, using this endpoint - your Tall Bob Group ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Your Tall Bob contact ID (required)

\n","type":"text"},{"key":"group_id","value":"{string}","description":"

Your Tall Bob group ID (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/groups/detach","description":"

You can remove a contact from your group, using this endpoint.

Required Parameters

Your request must contain both a contact_id parameter, representing your Tall Bob Contact ID and a group_id parameter, representing your Tall Bob Group ID.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

Name of group (required if external ID not present)

\n","type":"text"},{"key":"external_id","value":"{string}","contentType":"","description":"

An \"external\" ID used to match against your own records - must be unique (required if name not present, max length: 100)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/contacts/groups/{group_id}","description":"

You can update a group's details using this endpoint. Similar rules to the Create method apply.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"da6d0168-afe5-40b6-a096-e285f9869a3a","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Longcodes","item":[{"name":"Get Longcode Status","id":"3895a054-4eeb-41f2-9221-c8eaf606bba0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/longcodes/status/{longcode_request_id}","description":"

Retrieve status of a specific longcode using this endpoint - your longcode_address ID must be present in the URL path.

Possible Longcode Statuses:

pending: The longcode is under review or awaiting processing.
\n
approved: The longcode has been reviewed and approved.
\n
retired: The longcode is no longer active or has been decommissioned.
\n

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Post data to request a new longcode address with details provided. Upon successful creation, details of your new longcode request will be returned - including an ID, which is required by other methods to identify your newly created longcode request.

Required Parameters

Every request must contain a idn value, representing the Internation Dialing Number of the longcode requested , and a value for the comments field which represents the comments associated with a longcode request. Neither parameter can contain an empty value.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
idn	Number	International Dialing number for the country you are requesting a Long Code for
comments	String	Basic Description of use case for the Long Code
use_cases	ENUM Array	internal_comms, otp, transactional, marketing, notification, other

","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}},"urlObject":{"path":["v2","longcodes","request"],"host":["https://api.tallbob.com"],"query":[],"variable":[]}},"response":[{"id":"945674db-bbfb-459e-9c6d-a0805faa0a76","name":"Approved Status","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"idn\": 61,\n \"comments\": \"AU Longcode Request\",\n \"use_cases\": [\n \"internal_comms\",\n \"otp\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tallbob.com/v2/longcodes/request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 06 Feb 2025 00:02:48 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Cache-Control","value":"no-store, no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Security-Policy, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"Content-Security-Policy","value":"frame-ancestors 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"Tall Bob"},{"key":"Last-Modified","value":"Thursday, 06-Feb-2025 00:02:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 66,\n \"longcode_address\": \"61411111111\",\n \"idn\": 61,\n \"comment\": \"AU Longcode Request\",\n \"use_cases\": [\n \"internal_comms\",\n \"otp\"\n ],\n \"status\": \"approved\"\n}"},{"id":"eefcf696-a77f-4b4b-abec-3a7e3df6fdc4","name":"Pending Status","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"idn\": 61,\n \"comments\": \"AU Longcode Request\",\n \"use_cases\": [\n \"internal_comms\",\n \"otp\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tallbob.com/v2/longcodes/request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 06 Feb 2025 00:02:48 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Cache-Control","value":"no-store, no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Security-Policy, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"Content-Security-Policy","value":"frame-ancestors 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"Tall Bob"},{"key":"Last-Modified","value":"Thursday, 06-Feb-2025 00:02:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 66,\n \"longcode_address\": null,\n \"idn\": 61,\n \"comment\": \"AU Longcode Request\",\n \"use_cases\": [\n \"internal_comms\",\n \"otp\"\n ],\n \"status\": \"pending\"\n}"},{"id":"43c2c94b-235a-4927-8c8f-ea46ff6d6b1b","name":"Error: use_cases","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"idn\" : 61,\n \"comments\" : \"AU Longcode Request\",\n \"use_cases\" : [\"internal_comms\", \"test\"]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.tallbob.com/v2/longcodes/request"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"3d884ee0-ee11-4e4a-ba69-5a73b63162a8"},{"name":"Retire Longcode","id":"1ad2b646-9cc0-4db7-8f44-b0c9a3cde70d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"https://api.tallbob.com/v2/longcodes/retire/{longcode_address}","description":"

You can retire an existing longcode address using this endpoint - your longcode ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Manage Long Code requests for your account, you can request new Long codes, check the status of your requests and retire long codes when they are no longer required

Note:

Some longcodes may require additional information or take time to be approved, you make be contacted by our Support team for additional information.
\n
Charges may apply for your long code(s), please contact your Account Manager for clarification
\n

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"e788d7a9-5727-405f-862c-be443cfac942","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"MMS","item":[{"name":"List Inbound MMS Messages","id":"dfda0853-2c08-40d4-ad0d-04c25c4547da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/mms/inbound?to={integer}&after={timestamp}&before={timestamp}","description":"

Receive inbound MMS messages by request. You can send a request and retrieve inbound MMS messages at a time that suits you, using this endpoint. (note: MMS file/url details are unavailable from this endpoint, at this time)

Optional Filtering

You can filter your results by passing in optional query parameters to your request.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

parameter	description	type
to	filter by specific longcode	`integer`
after	filter by setting lower limit on dates	`timestamp`
before	filter by setting upper limit on dates	`timestamp`

The format of timestamps in your request is reasonably flexible... For example, 01/01/1970, 2001-12-31, 2002-10-20T12:26:13+00:00, last Monday and yesterday are all examples of valid inputs for these types of request.

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter by whichever longcode the MMS was sent to

\n","type":"text/plain"},"key":"to","value":"{integer}"},{"description":{"content":"

Filter by dates AFTER specified date (inclusive)

\n","type":"text/plain"},"key":"after","value":"{timestamp}"},{"description":{"content":"

Filter by dates BEFORE specified date (exclusive)

\n","type":"text/plain"},"key":"before","value":"{timestamp}"}],"variable":[]}},"response":[{"id":"e7af6d99-ee69-49c6-8e47-436848075846","name":"All Replies","originalRequest":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/mms/inbound"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:18:57 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 50,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 50,\n \"prev_page_url\": null,\n \"next_page_url\": \"https://api-test.tallbob.com/v2/mms/inbound?page=2\",\n \"data\": [\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:12:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:12:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:13:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:13:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:14:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:14:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:15:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:15:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:16:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:16:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:17:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:17:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:18:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:18:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:19:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:19:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:20:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:20:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:21:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:21:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:22:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:22:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:23:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:23:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:24:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:24:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:25:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:25:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:26:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:26:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:27:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:27:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:28:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:28:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:29:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:29:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:30:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:30:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:31:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:31:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:32:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:32:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:33:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:33:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:34:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:34:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:35:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:35:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:36:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\", \n \"timestamp\": \"2018-12-13T03:36:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n }\n ]\n}"},{"id":"1e5f47ef-599d-467e-8adc-633e68664597","name":"By Date","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/mms/inbound?after=2018-12-13&before=2018-12-13+03:30:00","host":["https://api.tallbob.com"],"path":["v2","mms","inbound"],"query":[{"key":"after","value":"2018-12-13","description":"inbound MMS messages on 13 Dec 2018 - starting at midnight (UTC)"},{"key":"before","value":"2018-12-13+03:30:00","description":"inbound MMS messages BEFORE 3:30AM on 13 Dec 2018 (UTC)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:18:57 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 3,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 3,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"subject\": \"FREE NACHOS\",\n \"timestamp\": \"2018-12-13T03:12:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498765498\",\n \"subject\": \"FREE NACHOS\",\n \"timestamp\": \"2018-12-13T03:12:54+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_03.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_04.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61429967196\",\n \"from\": \"61498774432\",\n \"subject\": \"FREE NACHOS\",\n \"timestamp\": \"2018-12-13T03:13:50+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_05.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_06.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n }\n ]\n}"},{"id":"6b819470-f459-4dad-a1a8-5f0cb321ad1b","name":"By Longcode","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/mms/inbound?to=61411222333","host":["https://api.tallbob.com"],"path":["v2","mms","inbound"],"query":[{"key":"to","value":"61411222333","description":"inbound MMS messages to the longcode 61411222333"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:41:27 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 3,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 3,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"mms_id\": null,\n \"to\": \"61411222333\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\",\n \"timestamp\": \"2019-09-10T00:30:25+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_00.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_01.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61411222333\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\",\n \"timestamp\": \"2019-09-10T00:31:25+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_02.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_03.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n },\n {\n \"mms_id\": null,\n \"to\": \"61411222333\",\n \"from\": \"61498765432\",\n \"subject\": \"electricity\",\n \"timestamp\": \"2019-09-10T00:32:25+00:00\",\n \"files\": [\n \"https://docs-test.tallbob.com/your/file_04.txt?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\",\n \"https://docs-test.tallbob.com/your/file_05.jpg?Expiry=TIMELIMIT&Signature=ThisIsImportantToInclude\"\n ]\n }\n ]\n}"}],"_postman_id":"dfda0853-2c08-40d4-ad0d-04c25c4547da"},{"name":"List MMS Receipts","id":"1d63758a-4d00-40ea-8fd7-6a1b4b461c93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/mms/receipts?to={integer}&after={timestamp}&before={timestamp}&status={string}","description":"

Receive MMS delivery reports by request. You can send a request and retrieve MMS delivery reports at a time that suits you, using this endpoint.

Optional Filtering

You can filter your results by passing in optional query parameters to your request.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

parameter	description	type
to	filter by recipient mobile number	`integer`
status	filter by delivery status	`string`
after	filter by setting lower limit on dates	`timestamp`
before	filter by setting upper limit on dates	`timestamp`

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter by MMS recipient

\n","type":"text/plain"},"key":"to","value":"{integer}"},{"description":{"content":"

Filter by dates AFTER specified date (inclusive)

\n","type":"text/plain"},"key":"after","value":"{timestamp}"},{"description":{"content":"

Filter by dates BEFORE specified date (exclusive)

\n","type":"text/plain"},"key":"before","value":"{timestamp}"},{"description":{"content":"

Filter by delivery status (case-insensitive)

\n","type":"text/plain"},"key":"status","value":"{string}"}],"variable":[]}},"response":[{"id":"ca10a4ae-1adb-4c53-a444-8e6ab7143c3d","name":"All Receipts","originalRequest":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/mms/receipts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 06 Feb 2020 23:57:01 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"item_count\": 2,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 2,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"mms_id\": \"91a58292-e1bd-11ea-af42-0242ac1b0005\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"Boss\",\n \"to\": \"61412345678\",\n \"subject\": \"Maiores neque quae ea consectetur.\",\n \"message\": null,\n \"delivered\": null,\n \"status\": \"POLLED\"\n },\n {\n \"mms_id\": \"1eeb6b76-e1af-11ea-837f-0242ac1b0005\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"Boss\",\n \"to\": \"61412345678\",\n \"subject\": \"Fugit aliquid expedita quos eos sequi in et.\",\n \"message\": null,\n \"delivered\": \"2020-08-19T02:17:48+00:00\",\n \"status\": \"DELIVERED\"\n }\n ]\n}"},{"id":"fdd85aae-8622-4ecf-ad0e-da62648e6e5e","name":"By Date","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/mms/receipts?after=2020-01-01&before=2020-10-01","host":["https://api.tallbob.com"],"path":["v2","mms","receipts"],"query":[{"key":"after","value":"2020-01-01","description":"Filter by MMS delivered STARTING 1st Quarter 2020"},{"key":"before","value":"2020-10-01","description":"Filter by dates BEFORE 4th Quarter 2020"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 05:14:34 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 64,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"mms_id\": \"1eeb6b76-e1af-11ea-837f-0242ac1b0005\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"Boss\",\n \"to\": \"61412345678\",\n \"subject\": \"Fugit aliquid expedita quos eos sequi in et.\",\n \"message\": null,\n \"delivered\": \"2020-08-19T02:17:48+00:00\",\n \"status\": \"DELIVERED\"\n }\n ]\n}"},{"id":"7a543cdc-e8f7-4d84-91a2-01e27cab0592","name":"By Recipient","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/mms/receipts?to=61499","host":["https://api.tallbob.com"],"path":["v2","mms","receipts"],"query":[{"key":"to","value":"61499","description":"Filter by MMS recipients begining with (+61) 499"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 05:13:47 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1898"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 64,\n \"item_count\": 0,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 0,\n \"last_item\": 0,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": []\n}"},{"id":"93cd767e-b288-41f2-86c7-240b4b0919bf","name":"By Status","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/mms/receipts?status=delivered","host":["https://api.tallbob.com"],"path":["v2","mms","receipts"],"query":[{"key":"status","value":"delivered","description":"Filter by DELIVERED status"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:57:06 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"mms_id\": \"1eeb6b76-e1af-11ea-837f-0242ac1b0005\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"Boss\",\n \"to\": \"61412345678\",\n \"subject\": \"Fugit aliquid expedita quos eos sequi in et.\",\n \"message\": null,\n \"delivered\": \"2020-08-19T02:17:48+00:00\",\n \"status\": \"DELIVERED\"\n }\n ]\n}"}],"_postman_id":"1d63758a-4d00-40ea-8fd7-6a1b4b461c93"},{"name":"Send MMS To List of Mobiles","id":"d68d86d8-f223-4a74-912a-4f55d0d6f6b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"to","value":"{integer}","description":"

Array of mobile numbers to send to - limited to 1000 (required)

\n","type":"text"},{"key":"from","value":"{string}","description":"

Your Sender ID - can be a longcode (required)

\n","type":"text"},{"key":"subject","value":"{string}","description":"

The MMS message subject text - limited to 60 chars (required)

\n","type":"text"},{"key":"url","value":"{string}","description":"

URL for the file to be used in the MMS (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

(Optional Field) message body text - limited to 5000 chars

\n","type":"text"},{"key":"shorten_urls","value":"{boolean}","description":"

(Optional Field) When true, any well formed URLs in your message will be replaced with shortened links

\n","type":"text"},{"key":"reference","value":"{string}","description":"

(Optional Field) transaction reference for tracking

\n","type":"text"},{"key":"campaign_reference","value":"{string}","description":"

(Optional Field) Used for custom report building

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/mms/send_list","description":"

If you want to send an MMS to a number of recipients, you can use this endpoint to send the same MMS to up to 1000 recipients in one go.

Required Parameters

You must include a to parameter. This value should be a list of recipient phone numbers in E.164 format.

You must also include a from parameter - this can be your phone number in E.164 format or an alphanumeric Sender ID - and a subject parameter, containing the subject line for the MMS. You can also include an optional message parameter, to accompany the file content.

The file content is provided using a url parameter. This must be a publicly accessible URL which requires no special auth headers to access the file and must be a link to a valid file type for MMS.

You can also include an optional reference parameter, which you can use for your own internal tracking as a transaction reference, when matching up against records you have set up in your own system, via webhooks you have set up in the platform.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Note: A single mobile number can also be used in the to field without needing to use an Array

Single mobile number in E.164 format (required)

\n","type":"text"},{"key":"from","value":"{string}","description":"

Your Sender ID - can be a longcode (required)

\n","type":"text"},{"key":"subject","value":"{string}","type":"text"},{"key":"url","value":"{string}","description":"

URL containing the media to be included in the MMS message

\n","type":"text"},{"key":"message","value":"{string}","type":"text"},{"key":"reference","value":"{string}","type":"text"},{"key":"campaign_reference","value":"{string}","description":"

(Optional Field) Used for custom report building

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/mms/send","description":"

To send a single outgoing MMS message, make an HTTP POST to this resource URI.

Required Parameters

When creating a new MMS message via the API, you must include a to parameter. This value should be a single recipient phone number in E.164 format.

The file content is provided using a url parameter. This must be a publicly accessible URL which requires no special auth headers to access the file and must be a link to a valid file type for MMS.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

For detailed information regarding this endpoint, please refer to our support documentation

Sending MMS via API
\n
List Inbound MMS Messages
\n

\n","_postman_id":"4c5f4b29-61d7-4d2b-bacd-b79915840345","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Opt-outs","item":[{"name":"Modify Opt-out","id":"9509edb8-0f4f-4b87-95eb-e1b8dd12dd51","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"mobile","value":"61499999999","description":"

Single mobile number in E.164 format (required)

\n","type":"text"},{"key":"type","value":"unsub","description":"

Expected value must be opt-in or opt-out

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/opt-out/mobile","description":"

Post data to insert or update the consent to receive SMS messages

Scenarios where this endpoint may be of use to you are:

Where you have one or more locations wherein a customer can modify their consent for SMS messaging such as an account management system on your website
Where you may collect Opt out or consent withdrawal requests through a third party system or process, for example a support portal or a Call Centre
Where you are managing the Opt out process and providing customers with the ability to opt back in to receiving messaging through a third party platform.

To learn more about the different ways to manage your opt outs through Tall Bob check out our support article

Required Parameters

Every request must contain:

a mobile value, representing the Mobile number to be stored with the consent record
a type value containing either 'opt-in' or 'opt-out' to specify the type of consent record to be stored

Note: The mobile field must conform to the E.164 format in order for our system to properly process and store your request

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"55cb2701-36ce-431c-885c-6a32eeb67265","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"SMS","item":[{"name":"Calculate SMS Price","id":"8085a154-bc3f-4964-be55-78f162b8d006","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"message","value":"{string}","description":"

Your SMS message text (required)

\n","type":"text"},{"key":"idn","value":"{string}","description":"

IDN you want to calculate price for (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/sms/price","description":"

Receive an estimate of the price for sending a particular message.

The result returned contains an estimate of the cost of sending the message to a single recipient, as well as the number of message \"segments\" and whether or not any characters not in the standard GSM 03.38 character set were detected - we call these \"unicode\" messages.

IDN

Along with your message, you should include the IDN - or International Dialing Number - sometimes referred to as Country Calling Code in your request, in order to receive the most accurate price for sending to a particular country. Note the + sign is optional and the request will work with or without it.

Message Length

If the number of characters in your message exceeds a certain length it is considered a \"multi-part\" message. The results also include how many of these segments your message would comprise of.

Common Error Messages

Here is a list of common error message that you will find in your response while sending a messsage. All of these will result in a 400 response code

Recipient opted out
\n
No valid recipients
\n
Invalid sender ID
\n
Recipient limit exceeded
\n
Mobile is empty
\n
Invalid mobile length
\n
Invalid IDN
\n

OPT-OUT tags

If your message contains an \"opt-out\" tag, the length and price returned will reflect the expansion of this tag into an actual, proper URL - which could potentially turn your message into a multi-part message, with more than one segment.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Receive delivery reports by request. You can send a request and retrieve delivery reports at a time that suits you, using this endpoint.

Optional Filtering

You can filter your results by passing in optional query parameters to your request.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

parameter	description	type
to	filter by recipient mobile number	`integer`
status	filter by delivery status	`string`
after	filter by setting lower limit on dates	`timestamp`
before	filter by setting upper limit on dates	`timestamp`

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter by SMS recipient

\n","type":"text/plain"},"key":"to","value":"{integer}"},{"description":{"content":"

Filter by dates AFTER specified date (inclusive)

\n","type":"text/plain"},"key":"after","value":"{timestamp}"},{"description":{"content":"

Filter by dates BEFORE specified date (exclusive)

\n","type":"text/plain"},"key":"before","value":"{timestamp}"},{"description":{"content":"

Filter by delivery status (case-insensitive)

\n","type":"text/plain"},"key":"status","value":"{string}"}],"variable":[]}},"response":[{"id":"f2305522-7ad1-460e-9b7b-257aad24a0a7","name":"All Receipts","originalRequest":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/sms/receipts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 06 Feb 2020 23:57:01 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"item_count\": 2,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 2,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"c5eede38-a6bb-11e9-abae-0617db59baea\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"unik\",\n \"to\": \"61412345678\",\n \"message\": \"http://vc1.me/uIev\",\n \"delivered\": null,\n \"status\": \"POLLED\",\n \"num_segments\": 1,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"3709cad4-e568-11e9-8fac-0227e6a58070\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"unik\",\n \"to\": \"61412345678\",\n \"message\": \"http://vc1.me/WGoC\",\n \"delivered\": \"2019-10-02T22:58:59+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 1,\n \"unicode\": 0\n }\n ]\n}"},{"id":"cb6f3924-c7eb-4d32-b481-02c2fe9fa5c9","name":"By Date","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/receipts?after=2019-01-01&before=2020-01-01","host":["https://api.tallbob.com"],"path":["v2","sms","receipts"],"query":[{"key":"to","value":"{int}","description":"Filter by SMS recipient","disabled":true},{"key":"after","value":"2019-01-01","description":"Filter by dates AFTER specified date (inclusive)"},{"key":"before","value":"2020-01-01","description":"Filter by dates BEFORE specified date (exclusive)"},{"key":"status","value":"{string}","description":"Filter by delivery status (case-insensitive)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 05:14:34 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 64,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"3709cad4-e568-11e9-8fac-0227e6a58070\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"unik\",\n \"to\": \"61412345678\",\n \"message\": \"http://vc1.me/WGoC\",\n \"delivered\": \"2019-10-02T22:58:59+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 1,\n \"unicode\": 0\n }\n ]\n}"},{"id":"b176da3f-498a-468a-bcb9-985108bbc1d2","name":"By Recipient","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/receipts?to=61412345670","host":["https://api.tallbob.com"],"path":["v2","sms","receipts"],"query":[{"key":"to","value":"61412345670","description":"Filter by SMS recipient"},{"key":"after","value":"{timestamp}","description":"Filter by dates AFTER specified date (inclusive)","disabled":true},{"key":"before","value":"{timstamp}","description":"Filter by dates BEFORE specified date (exclusive)","disabled":true},{"key":"status","value":"{string}","description":"Filter by delivery status (case-insensitive)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 05:13:47 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1898"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 64,\n \"item_count\": 0,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 0,\n \"last_item\": 0,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": []\n}"},{"id":"a57f1aac-aa5a-43c6-838b-fea81132c577","name":"By Status","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/receipts?status=delivered","host":["https://api.tallbob.com"],"path":["v2","sms","receipts"],"query":[{"key":"status","value":"delivered"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:57:06 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"3709cad4-e568-11e9-8fac-0227e6a58070\",\n \"contact_id\": \"63cd6f30-2a92-11e9-9461-02aa10802064\",\n \"from\": \"unik\",\n \"to\": \"61412345678\",\n \"message\": \"http://vc1.me/WGoC\",\n \"delivered\": \"2019-10-02T22:58:59+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 1,\n \"unicode\": 0\n }\n ]\n}"}],"_postman_id":"f616f578-a0e2-451e-9861-3ed04b8c998c"},{"name":"List SMS Replies","id":"4d9f9a1d-73c9-461a-b1f5-ed5d2a8b2d59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/sms/replies?to={integer}&after={timestamp}&before={timestamp}&campaign_id={string}","description":"

Receive inbound SMS messages (replies) by request. You can send a request and retrieve message replies at a time that suits you, using this endpoint.

Optional Filtering

You can filter your results by passing in optional query parameters to your request.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

parameter	description	type
to	filter by specific longcode	`integer`
after	filter by setting lower limit on dates	`timestamp`
before	filter by setting upper limit on dates	`timestamp`
campaign_id	filter by campaign id	`string`

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Also please make sure that if you are using the 'before' and 'after' fields, that the dates should be URL encoded.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter by recipient of the SMS replies.

\n","type":"text/plain"},"key":"to","value":"{integer}"},{"description":{"content":"

Filter by dates AFTER specified date (inclusive, must be URL encoded)

\n","type":"text/plain"},"key":"after","value":"{timestamp}"},{"description":{"content":"

Filter by dates BEFORE specified date (exclusive, must be URL encoded)

\n","type":"text/plain"},"key":"before","value":"{timestamp}"},{"description":{"content":"

Filter by campaign id of the SMS replies

\n","type":"text/plain"},"key":"campaign_id","value":"{string}"}],"variable":[]}},"response":[{"id":"8387921c-4bd2-4c43-940c-45a94797e938","name":"All Replies","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/replies","host":["https://api.tallbob.com"],"path":["v2","sms","replies"],"query":[{"key":"to","value":"61499000100","disabled":true},{"key":"after","value":"","disabled":true},{"key":"before","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:18:57 GMT"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 50,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 50,\n \"prev_page_url\": null,\n \"next_page_url\": \"https://api-test.tallbob.com/v2/sms/replies?page=2\",\n \"data\": [\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:12:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:12:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:13:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:13:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:14:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:14:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:15:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:15:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:16:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:16:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:17:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:17:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:18:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:18:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:19:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:19:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:20:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:20:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:21:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:21:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:22:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:22:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:23:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:23:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:24:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:24:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:25:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:25:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:26:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:26:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:27:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:27:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:28:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:28:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:29:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:29:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:30:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:30:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:31:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:31:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:32:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:32:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:33:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:33:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:34:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:34:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:35:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:35:54+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:36:50+00:00\",\n \"reference\": \"ABC\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:36:54+00:00\",\n \"reference\": \"ABC\"\n }\n ]\n}"},{"id":"184410da-82e0-454d-8490-967dc9119223","name":"By Campaign ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/replies?campaign_id=5c11a83e43312","host":["https://api.tallbob.com"],"path":["v2","sms","replies"],"query":[{"key":"to","value":"{integer}","description":"Filter by recipient of the SMS replies.","disabled":true},{"key":"after","value":"{timestamp}","description":"Filter by dates AFTER specified date (inclusive)","disabled":true},{"key":"before","value":"{timestamp}","description":"Filter by dates BEFORE specified date (exclusive)","disabled":true},{"key":"campaign_id","value":"5c11a83e43312","description":"Filter by campaign id of the SMS replies"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 13 Oct 2022 23:03:21 GMT"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 1,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61412345678\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2019-09-10T00:30:25+00:00\",\n \"reference\": \"ABC\"\n }\n ]\n}"},{"id":"1db14894-0f5a-4eb5-8ee4-913458a1844b","name":"By Date","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/replies?after=2018-12-13&before=2018-12-13+03:30:00","host":["https://api.tallbob.com"],"path":["v2","sms","replies"],"query":[{"key":"to","value":"61499000100","disabled":true},{"key":"after","value":"2018-12-13"},{"key":"before","value":"2018-12-13+03:30:00"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:18:57 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 36,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 36,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:12:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:12:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:13:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:13:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:14:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:14:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:15:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:15:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:16:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:16:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:17:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:17:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:18:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:18:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:19:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:19:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:20:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:20:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:21:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:21:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:22:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:22:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:23:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:23:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:24:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:24:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:25:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:25:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:26:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:26:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:27:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:27:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:28:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:28:54+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:29:50+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61429967196\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2018-12-13T03:29:54+00:00\"\n }\n ]\n}"},{"id":"d78006c9-8267-4849-b5dd-2ce1b8dc52e8","name":"By Longcode","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/sms/replies?to=61412345678","host":["https://api.tallbob.com"],"path":["v2","sms","replies"],"query":[{"key":"to","value":"61412345678"},{"key":"after","value":"2018-12-13","disabled":true},{"key":"before","value":"2018-12-13+03:30:00","disabled":true},{"key":"per_page","value":"20","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 00:41:27 GMT"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 34795,\n \"item_count\": 2,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 2,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61412345678\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2019-09-10T00:30:25+00:00\"\n },\n {\n \"campaign_id\": \"5c11a83e43312\",\n \"to\": \"61412345678\",\n \"from\": \"61498765432\",\n \"incoming_message\": \"BLARG\",\n \"keyword\": null,\n \"timestamp\": \"2019-09-10T00:31:25+00:00\"\n }\n ]\n}"}],"_postman_id":"4d9f9a1d-73c9-461a-b1f5-ed5d2a8b2d59"},{"name":"Send Single SMS","id":"5e54d98b-c133-4d8c-9ef0-e50fc569cfc4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"from","value":"{string}","description":"

Your Sender ID - can be a longcode (required)

\n","type":"text"},{"key":"to","value":"{string}","description":"

Single mobile number in E.164 format (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

Your SMS message text (required)

\n","type":"text"},{"key":"reference","value":"{string}","description":"

(Optional Field) Transaction reference for tracking messages

\n","type":"text"},{"key":"shorten_urls","value":"{boolean}","description":"

(Optional Field) When true, any well formed URLs in your message will be replaced with shortened links

\n","type":"text"},{"key":"campaign_reference","value":"{string}","description":"

(Optional Field) Used for custom report building

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/sms/send","description":"

To send a single outgoing message, make an HTTP POST to this resource URI.

Opt-Out tags

If your message contains an \"opt-out\" tag {OptOutURL}, the length and price returned will reflect the expansion of this tag into an actual, proper URL - which could potentially turn your message into a multi-part message, with more than one segment.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Short URLs

If your message contains URL's and you would like it to be replaced with a shorter URL, or you would like to use our system to track engagement with the link, you can provide this endpoint with an optional boolean parameter shorten_urls, when this value is true any well formed URL (i.e. Must start with http:// or https:// ) will be replaced with a shorter one.

If your account has a pURL (Personalised URL) configured, it will use that configured domain for the URL.

By default the shortened URLs will look like http://vc4.co/c/ABCD where the \"ABCD\" will be replaced with a unique code for your URL. Note, these URLs are 20 characters in length, if your URL is longer than 20 characters, it will end up longer than it was originally. Any pURL configurations may make this length longer as well.

Required Parameters

When creating a new message via the API, you must include a to parameter. This value should be a single recipient phone number in E.164 format.

You must also include a from parameter. This can be your phone number in E.164 format or an alphanumeric Sender ID.

Finally, you need to include a message parameter containing the message's content. If this value exceeds a certain length it is regarded as a \"multi-part\" message.

You can also include an optional reference parameter, which you can use for your own internal tracking, as a transaction reference, when matching up against webhooks you have set up.

Your Sender ID - can be a longcode (required)

\n","type":"text"},{"key":"to","value":"{array}","description":"

Array of mobile numbers to send to - limited to 1000 (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

Your SMS message - the same message will be sent to all recipients (required)

\n","type":"text"},{"key":"reference","value":"{string}","description":"

(Optional Field) transaction reference for tracking

\n","type":"text"},{"key":"shorten_urls","value":"{boolean}","description":"

(Optional Field) - When true, any well formed URLs in your message will be replaced with shortened links

\n","type":"text"},{"key":"campaign_reference","value":"{string}","description":"

(Optional Field) Used for custom report building

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/sms/list_send","description":"

Basic usage

If you want to send to a number of recipients, you can use this endpoint to send the same message to up to 1000 recipients in one go.

Personalised usage

If you want to send 'personalised' messages (a slightly different message to each recipient) to your recipients, you can also use this end point.

Personalisation is done using the liquid template engine. To personalise a message the use of double curly braces should be used to enable the replacement.. e.g. {{ name }}

Default values can also be provided and will be used if no data was supplied. e.g. {{ name | default: 'Bob' }}

Note: If no data and no default value is provided, the content inside the double curly braces will be replaced by an empty string.

Note: Default values can use pairs of ' or \" Because the API uses JSON, caution should be used during development around the double quote, \" These characters need to appear escaped within the message. e.g. default: \\\"Tall\\\"

Opt-Out tags

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Short URLs

If your account has a pURL (Personalised URL) configured, it will use that configured domain for the URL.

Note: Each recipient in your batch will have their own unique URL code that can provide individualised engagement data.

Personalised Short URLs

The above short URL feature only covers the situation where a URL is in your message content. If desired, you can also use individual links for each of your recipients using the personalisation system. Instead of passing the boolean flag, to use short URLs, the personalisation field needs to be in a specific way.

Your message will need to contain the string {{ url | shorten_url }} and your to array will also required the url parameter set.

Required Parameters

You must include a to parameter. This value should be a list of recipient phone numbers in E.164 format.

You must also include a from parameter. This can be your phone number in E.164 format or an alphanumeric Sender ID.

Finally, you need to include a message parameter containing the message's content. If the number of characters in your message exceeds a certain length it is considered a \"multi-part\" message - and billed accordingly.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Basic usage example:

{\n    \"to\" : [\"+6141xxxxxx1\", \"+6141xxxxxx2\"],\n    \"from\": \"Sender\",\n    \"message\": \"Hi, this is an SMS message\"\n}\n\n

Personalised message example:

Data supplied for personalisation should be in the form of a list as above, the 'keys' of the to field will be the recipients mobile number, and the content of each item in the list will be the data used to personalise the message. (Data can be defined as both an array/list or as an object)

{\n    \"to\" : {\n        \"+6141xxxxxx1\": {\"name\": \"Sample1\"}, \n        \"+6141xxxxxx2\": {\"name\": \"Sample2\"},\n        \"+6141xxxxxx3\": {},\n    },\n    \"from\": \"Sender\",\n    \"message\": \"Hi {{ name | default: 'there' }}, this is an SMS message\"\n}\n\n

This payload will result in 3 messages being sent with the following content:

Hi Sample1, this is an SMS message

Hi Sample2, this is an SMS message

Hi there, this is an SMS message

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"b1f1790a-aaef-48c1-8d74-6ecb6f282748","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"SMS Campaign","item":[{"name":"List Campaign Recipients","id":"548f429f-4f14-49ee-b033-16e3090999a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/campaigns/{campaign_id}/contacts","description":"

Get list of recipients (contacts) against a specific SMS campaign. You can send a request and retrieve data about SMS recipients for a campaign at a time that suits you, using this endpoint - your Tall Bob SMS Campaign ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}},"urlObject":{"path":["v2","campaigns","{campaign_id}","contacts"],"host":["https://api.tallbob.com"],"query":[],"variable":[]}},"response":[{"id":"d0f01b15-e274-45f8-8980-61302dff7afe","name":"View Contacts","originalRequest":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/campaigns/3709cad4-e568-11e9-8fac-0227e6a58070/contacts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 01:50:17 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 62,\n \"item_count\": 50,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 50,\n \"prev_page_url\": null,\n \"next_page_url\": \"https://api-test.tallbob.com/v2/campaigns/5c11aa495f341/contacts?page=2\",\n \"data\": [\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"4f73c5ff5d50c\",\n \"from\": \"TallBob\",\n \"to\": \"61402123100\",\n \"message\": \"Hi Ryan,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/Ku0E.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:17+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80e9c7e\",\n \"from\": \"TallBob\",\n \"to\": \"61434406212\",\n \"message\": \"Hi Frazer,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/wZzb.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:18+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80e9d47\",\n \"from\": \"TallBob\",\n \"to\": \"61418545389\",\n \"message\": \"Hi Alastair,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/bDnF.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:31:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80e9e02\",\n \"from\": \"TallBob\",\n \"to\": \"61488756491\",\n \"message\": \"Hi Robert,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/tXts.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:35:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80e9eac\",\n \"from\": \"TallBob\",\n \"to\": \"61425754575\",\n \"message\": \"Hi Robert,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/sEY8.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:32+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80e9f51\",\n \"from\": \"TallBob\",\n \"to\": \"61431640230\",\n \"message\": \"Hi Kirsten,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/2X4e.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:27:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea00f\",\n \"from\": \"TallBob\",\n \"to\": \"61488732295\",\n \"message\": \"Hi Sean,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/Eea1.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:27+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea0c8\",\n \"from\": \"TallBob\",\n \"to\": \"61419599206\",\n \"message\": \"Hi Geoff,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/vQiP.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:14+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea168\",\n \"from\": \"TallBob\",\n \"to\": \"61418414324\",\n \"message\": \"Hi Owen,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/QDwr.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea21e\",\n \"from\": \"TallBob\",\n \"to\": \"61427119655\",\n \"message\": \"Hi Damien,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/s29c.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:32+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea2bb\",\n \"from\": \"TallBob\",\n \"to\": \"61428848211\",\n \"message\": \"Hi Phil,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/WJN7.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:27:15+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea374\",\n \"from\": \"TallBob\",\n \"to\": \"61417524072\",\n \"message\": \"Hi Ross,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/hAR3.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:28:50+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea434\",\n \"from\": \"TallBob\",\n \"to\": \"61418199918\",\n \"message\": \"Hi Geoff,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/uDHf.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:42:00+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea4cf\",\n \"from\": \"TallBob\",\n \"to\": \"61419177099\",\n \"message\": \"Hi Mark,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/kCgR.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:34+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea579\",\n \"from\": \"TallBob\",\n \"to\": \"61448675928\",\n \"message\": \"Hi Travis,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/vCJ0.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:21+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea633\",\n \"from\": \"TallBob\",\n \"to\": \"61419104317\",\n \"message\": \"Hi Peter,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/H8FU.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea6dd\",\n \"from\": \"TallBob\",\n \"to\": \"61417861772\",\n \"message\": \"Hi Paul,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/QQpP.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:28:50+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea787\",\n \"from\": \"TallBob\",\n \"to\": \"61439397024\",\n \"message\": \"Hi Chris,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/eSZ9.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea849\",\n \"from\": \"TallBob\",\n \"to\": \"61418341646\",\n \"message\": \"Hi Graeme,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/GlBS.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:19+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea8f4\",\n \"from\": \"TallBob\",\n \"to\": \"61419396414\",\n \"message\": \"Hi Jody,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/V7dD.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:27:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ea99d\",\n \"from\": \"TallBob\",\n \"to\": \"61428550030\",\n \"message\": \"Hi Clint,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/ujUa.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eaa46\",\n \"from\": \"TallBob\",\n \"to\": \"61408515155\",\n \"message\": \"Hi Dennis,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/qFUM.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:28:50+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eaaff\",\n \"from\": \"TallBob\",\n \"to\": \"61410408519\",\n \"message\": \"Hi Robert,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/j6pA.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:30+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eaba9\",\n \"from\": \"TallBob\",\n \"to\": \"61419104726\",\n \"message\": \"Hi Roger,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/b6Hm.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:18+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eac52\",\n \"from\": \"TallBob\",\n \"to\": \"61438120973\",\n \"message\": \"Hi Craig,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/rlRp.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:31+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ead08\",\n \"from\": \"TallBob\",\n \"to\": \"61400868070\",\n \"message\": \"Hi Craig,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/nMVe.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:32+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eadb2\",\n \"from\": \"TallBob\",\n \"to\": \"61425754575\",\n \"message\": \"Hi Robert,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/uwu7.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:32+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eae69\",\n \"from\": \"TallBob\",\n \"to\": \"61417855116\",\n \"message\": \"Hi Adam,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/yjBE.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eaf11\",\n \"from\": \"TallBob\",\n \"to\": \"61425804115\",\n \"message\": \"Hi Matt,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/MDaE.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T01:27:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eafb3\",\n \"from\": \"TallBob\",\n \"to\": \"61447003092\",\n \"message\": \"Hi Brendan,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/MVXl.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:19+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb078\",\n \"from\": \"TallBob\",\n \"to\": \"61404817804\",\n \"message\": \"Hi Nick,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/TB7P.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb114\",\n \"from\": \"TallBob\",\n \"to\": \"61418247600\",\n \"message\": \"Hi Geoff,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/KpM1.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:20+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb1c8\",\n \"from\": \"TallBob\",\n \"to\": \"61418331620\",\n \"message\": \"Hi Dennis,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/tA4Z.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:32+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb272\",\n \"from\": \"TallBob\",\n \"to\": \"61400258909\",\n \"message\": \"Hi Jason,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/ra6w.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:20+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb31f\",\n \"from\": \"TallBob\",\n \"to\": \"61425850078\",\n \"message\": \"Hi Martin,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/v81f.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb3dd\",\n \"from\": \"TallBob\",\n \"to\": \"61418572727\",\n \"message\": \"Hi Peter,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/P7ie.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb48f\",\n \"from\": \"TallBob\",\n \"to\": \"61400902525\",\n \"message\": \"Hi Joanne,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/rHJw.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb544\",\n \"from\": \"TallBob\",\n \"to\": \"61419398768\",\n \"message\": \"Hi Michael,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/up2Q.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:31+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb5ed\",\n \"from\": \"TallBob\",\n \"to\": \"61401502883\",\n \"message\": \"Hi Nick,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/fYv2.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:44+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb697\",\n \"from\": \"TallBob\",\n \"to\": \"61412523447\",\n \"message\": \"Hi Simon,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/DzSx.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:21+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb75d\",\n \"from\": \"TallBob\",\n \"to\": \"61403187840\",\n \"message\": \"Hi Steve,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/hsTu.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:18+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb7f9\",\n \"from\": \"TallBob\",\n \"to\": \"61438487053\",\n \"message\": \"Hi Simone,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/oUJp.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-27T00:32:15+00:00\",\n \"status\": \"UNDELIVERABLE\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb8a3\",\n \"from\": \"TallBob\",\n \"to\": \"61409686044\",\n \"message\": \"Hi John,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/5OCZ.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eb94d\",\n \"from\": \"TallBob\",\n \"to\": \"61425149292\",\n \"message\": \"Hi Nick,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/MlDU.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:18+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80eba06\",\n \"from\": \"TallBob\",\n \"to\": \"61408538300\",\n \"message\": \"Hi Craig,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/UTNG.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ebb5e\",\n \"from\": \"TallBob\",\n \"to\": \"61415331031\",\n \"message\": \"Hi Paul,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/CW0b.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:19+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ebc08\",\n \"from\": \"TallBob\",\n \"to\": \"61414510333\",\n \"message\": \"Hi Leane,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/CTKm.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:35+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ebcd0\",\n \"from\": \"TallBob\",\n \"to\": \"61438516628\",\n \"message\": \"Hi Kerri,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/2Was.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:16+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ebd6c\",\n \"from\": \"TallBob\",\n \"to\": \"61410043213\",\n \"message\": \"Hi Scott,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/XWxw.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:37+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n },\n {\n \"campaign_id\": \"5c11aa495f341\",\n \"contact_id\": \"51c8cb80ebe21\",\n \"from\": \"TallBob\",\n \"to\": \"61437333726\",\n \"message\": \"Hi Beth,\\nClick the link to view a free Training Snippet video using the Tall Bob platform- http://vc4.co/GiBJ.\\nVideo's can be integrated with driver or employee numbers too.\\nCheers\\nRyan (1300-131-657) and Robyn (9696-3947)\",\n \"delivered\": \"2013-06-25T00:30:18+00:00\",\n \"status\": \"DELIVERED\",\n \"num_segments\": 2,\n \"unicode\": 0\n }\n ]\n}"}],"_postman_id":"548f429f-4f14-49ee-b033-16e3090999a3"},{"name":"List Campaign Templates","id":"2cf85807-39d1-4a10-bf9f-fd8c6d027b9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/campaigns/templates","description":"

Get a list of the templates your SMS Campaigns are built from - which is useful as the Tall Bob Template ID is required when sending an SMS Campaign. You can send a request and retrieve Campaign Templates at a time that suits you, using this endpoint.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Get list of SMS campaigns for your account, by request. You can send a request and retrieve SMS campaigns at a time that suits you, using this endpoint.

Optional Filtering

You can filter your results by passing in optional query parameters to your request.

after - filter by setting lower limit on dates (timestamp)
before - filter by setting upper limit on dates (timestamp)

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter by dates AFTER specified date (inclusive)

\n","type":"text/plain"},"key":"after","value":"{timestamp}"},{"description":{"content":"

Filter by dates BEFORE specified date (exclusive)

\n","type":"text/plain"},"key":"before","value":"{timestamp}"}],"variable":[]}},"response":[{"id":"488e26bb-dc16-4513-a6e6-14c1d9b958f0","name":"Campaigns","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/campaigns/","host":["https://api.tallbob.com"],"path":["v2","campaigns",""],"query":[{"key":"after","value":"","description":"Filter by dates AFTER specified date (inclusive)","disabled":true},{"key":"before","value":"","description":"Filter by dates BEFORE specified date (exclusive)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 01:15:45 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 4,\n \"item_count\": 4,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 4,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"3709cad4-e568-11e9-8fac-0227e6a58070\",\n \"timestamp\": \"2019-10-02T22:58:57+00:00\",\n \"title\": \"unique test\",\n \"template\": null,\n \"sends\": 1,\n \"deliveries\": 0\n },\n {\n \"id\": \"5c11a83e43312\",\n \"timestamp\": \"2018-12-13T00:30:54+00:00\",\n \"title\": \"mo code mayhem\",\n \"template\": null,\n \"sends\": 1,\n \"deliveries\": 0\n },\n {\n \"id\": \"5c11aa495f341\",\n \"timestamp\": \"2019-02-25T04:25:13+00:00\",\n \"title\": \"\",\n \"template\": \"5c11a8b2e30d4\",\n \"sends\": 1081,\n \"deliveries\": 0\n },\n {\n \"id\": \"c5eede38-a6bb-11e9-abae-0617db59baea\",\n \"timestamp\": \"2019-07-15T04:48:22+00:00\",\n \"title\": \"unique test\",\n \"template\": null,\n \"sends\": 1,\n \"deliveries\": 0\n }\n ]\n}"},{"id":"21f0ac85-e138-4fba-a973-1cb091f14924","name":"By Dates","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/campaigns/?after=2019-01-01&before=2019-12-31","host":["https://api.tallbob.com"],"path":["v2","campaigns",""],"query":[{"key":"after","value":"2019-01-01","description":"Filter by dates AFTER specified date (inclusive)"},{"key":"before","value":"2019-12-31","description":"Filter by dates BEFORE specified date (exclusive)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 07 Feb 2020 01:18:01 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 4,\n \"item_count\": 2,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 2,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"3709cad4-e568-11e9-8fac-0227e6a58070\",\n \"timestamp\": \"2019-10-02T22:58:57+00:00\",\n \"title\": \"unique test\",\n \"template\": null,\n \"sends\": 1,\n \"deliveries\": 0\n },\n {\n \"id\": \"c5eede38-a6bb-11e9-abae-0617db59baea\",\n \"timestamp\": \"2019-07-15T04:48:22+00:00\",\n \"title\": \"unique test\",\n \"template\": null,\n \"sends\": 1,\n \"deliveries\": 0\n }\n ]\n}"}],"_postman_id":"8186e06d-8a68-4b51-9c48-0fed4552b0fb"},{"name":"Send SMS Campaign","id":"ba0153c1-6af6-486e-a144-4054450c2a22","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"group_id\": \"random-id\"\n}"},"url":"https://api.tallbob.com/v2/campaigns/send","description":"

You can send an SMS campaign using a campaign Template, allowing more advanced features such as Personalisation and Landing Pages, with Videos and even Forms.

Required Parameters

You must include a template_id parameter. This value should be a Tall Bob Campaign Template ID, which can be listed using another endpoint.

You must also include (only) one of the following parameters:

group_id - this is a Tall Bob Group ID - which represents a list of Tall Bob contacts - which can be as large a list as you need it to be
contact_ids - this is a list (array) of Tall Bob contacts, identified by their Tall Bob Contact ID - limited to 1000
external_ids - this is a list (array) of Tall Bob contacts, identified by your own Unique ID, which corresponds to the ID you use in your system to identify them - also limited to 1000

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

List of mobiles (and optional data) to sent campaign to

\n","type":"text"},{"key":"from","value":"{string}","description":"

Your Sender ID - can be a longcode (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

Your SMS message - the same message will be sent to all recipients (required)

\n","type":"text"},{"key":"landing_page_id","value":"{string}","description":"

Your Tall Bob Landing Page ID (required)

\n","type":"text"},{"key":"video_id","value":"{string}","description":"

Your Tall Bob Video ID (optional)

\n","type":"text"},{"key":"reference","value":"{string}","description":"

Your campaign reference - Using the same campaign reference will accross requests will combine multiple requests into a single campaign (optional)

\n","type":"text"},{"key":"","value":"","type":"text","disabled":true}]},"url":"https://api.tallbob.com/v2/campaigns/send_via_mobile","description":"

You can send an SMS campaign to a list of mobile numbers. This allows more advanced features such as Personalisation and Landing Pages, Forms and Videos.

To support personalisation in both message content and Landing Pages, the list of mobile numbers that is sent to is created as 'Contacts' within our system.

Required Parameters

* to - this is a list (array) of objects, these objects will be created as 'contacts' and then sent to. Array/list keys are mobiles, the data of each keyed object is any additional data to be stored with the contact. Note the maximum list size accepted is limited to 1000 contacts. To have more contacts in a campaign please see the information about the reference\n* from - This is your sender address, This can be your phone number in E.164 format or an alphanumeric Sender ID.\n* message - Your SMS message content to be sent. You are required to include a{{ campaign_link }} , this will be where your landing page will be linked to.\n* landing_page_id - The ID of your landing page, this is the page that will be linked to within your message.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Contact Data

Data provided in the to field will be saved/updated into individual contact records.

Contacts have a set of standard fields across all accounts - first_name, last_name, mobile, email, external_id .

Any additional fields sent will be stored as 'contact metadata'. If they do not exist, they will be created. These fields can then be used when building landing pages or messages from within the platform.

The external_id will be used as a primary key when deciding to create or update existing contacts. It is highly recommended to include an external_id from the requesting system. This external ID will be provided in any webhooks that have been configured so that the contact can be identified by your system.

To avoid excess duplicates being created within the platform, we will use the mobile number provided if this value is empty.

Personalisation:

Please see the information at this endpoint

Optional Parameters

* video_id - The ID of the video that will be inserted on your landing page\n* reference - Your reference for the 'campaign'. This reference will be returned in any events connected via webhooks. The reference value also has a special use-case - Under the circumstances where multiple requests are required to send a complete campaign (when # of contacts is greater than 1000) providing the same reference will allows these multiple lists to be combined. When viewing this within the platform analytics, it will appear as a single campaign.

Retrieve details about a specific SMS campaign, by Campaign ID using this endpoint - your Tall Bob SMS Campaign ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Retrieve details about a specific Campaign Template by ID, using this endpoint - your Tall Bob Campaign Template ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"f639a1ae-a5e3-4f2d-a60c-a1245439a322","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Simulated Actions","item":[{"name":"Create mock MO Message","id":"0c5f8165-4a37-49aa-8331-644258bc2acf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"longcode","value":"{string}","description":"

A longcode assigned to your account (A mobile number in E.164 format). This is the number being sent to. (required)

\n","type":"text"},{"key":"sender","value":"{string}","description":"

Single mobile number. This will be the number that the message is being sent from (required)

\n","type":"text"},{"key":"message","value":"{string}","description":"

Your message text (required)

\n","type":"text"}]},"url":"https://api.tallbob.com/support/mo/send","description":"

This endpoint has been made available to assist customers while exploring and developing integrations.

This endpoint is only available on our test systems (api-test.tallbob.com)

Use of this endpoint requires a longcode to have been assigned to your test account. To have one of these assigned, please contact support@tallbob.com to have this arranged.

Sending a request to this endpoint will 'fake' an inbound message to the 'longcode' in the request, from 'sender'. \nThis message will be processed in the same way a real message would get processed on our production system. This includes activating any triggers and generating a 'message_received' payload when a web hook has been setup.

Success Response

Note: this endpoint does not return any content upon success.

A successful response will have an HTTP STATUS of 204 instead of the usual 200

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"588790d6-5939-482c-a95b-62c3bd7e99c4","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Utilities","item":[{"name":"Mobile Lookup","id":"ed5f6993-76a4-4aa3-b500-7b4c6c86768f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"","value":"","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"mobile","value":"{string}","description":"

The mobile number to look up.

\n","type":"text","uuid":"cd8e2e75-9532-4c17-b3ec-82d0b15285d8"},{"key":"details","value":"{boolean}","description":"

If true, additional lookup details will be included in the response. Defaults to false.

\n","type":"text","uuid":"52899ef3-407e-4eb4-9fd5-127a027b80df","disabled":true}]},"url":"https://api.tallbob.com/v2/utils/mobile_lookup","description":"

This endpoint provides clients a mobile lookup to complete number validation in real time.

Required Parameters

Every request must contain:

a mobile value, representing the Mobile number

Note: The mobile field must conform to the E.164 format

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"3eb57d02-ade4-48ac-80e8-e54b6fd8738e","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Webhooks","item":[{"name":"Create New Webhook","id":"b44583f4-54bc-4da3-b874-76fa5ebcbd34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"url","value":"{string}","description":"

URL of your webhook (max length: 255)

\n","type":"text"},{"key":"event_type","value":"{string}","description":"

Event type (see above for valid event types)

\n","type":"text"},{"key":"enabled","value":"{boolean}","description":"

Whether or not the webhook should be enabled (optional)

\n","type":"text"},{"key":"name","value":"{string}","description":"

Name for the webhook (optional)

\n","type":"text"},{"key":"authorization","value":"{string}","description":"

Auth header if required to POST to your webhook (optional)

\n","type":"text"},{"key":"content-type","value":"{string}","description":"

Content Type header if default JSON type unsupported (optional)

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/webhooks","description":"

Post data to create a new webhook with details provided. Upon successful creation, details of your new webhook will be returned - including an ID, which is required by other methods to identify your newly created webhook.

Required Parameters

Every request must contain a url value, representing the URL to post data to, and a value for the event_type which represents the trigger for sending the data to your webhook. Neither parameter can contain an empty value. The url MUST be an SSL-encrypted endpoint (beginning with https://) with a valid certificate.

Event Types

Valid event types are as follows:

message_polling - Message prepared for delivery
message_pushed - Message sent
message_delivered - Message delivered
message_delivery_error - Delivery failed
message_received - Response received
message_received_mms - MMS Response received
message_opened - Email opened
impression - Landing Page viewed
clicktrack - Contact clicked ordinary link
unsubscribe_track - Contact clicked unsubscribe link
unsubscribe - Contact opted out
video_play - Video played
video_complete - Video ended
form_submission - Form submitted
scratchie_initiated - Scratchie rendered
scratchie_interact - Scratchie interacted with

Optional Parameters

If your webhook requires additional information to be included in the header, such as a Basic Auth string, these can also be included in your request. Currently only two such optional parameters are supported:

`authorization`

You can set the authorisation header used when posting to your webhooks using this parameter. It should be the entire auth string.

eg Basic <>

`content-type`

You can set the \"Content-Type\" header used when posting to your webhooks using this parameter. By default, this is already set to application-json so if your webhook supports posting JSON data, you do not need to set this value.

Note: only two types are currently supported - application-json and application/x-www-form-urlencoded

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Delete a specific webhook using this endpoint - your webhook ID must be present in the URL path.

Success Response

Note: this endpoint does not return any content upon success.

Furthermore, a successful response will have an HTTP STATUS of 204 instead of the usual 200

List of webhooks for your account, by request. You can send a request and retrieve your list at a time that suits you, using this endpoint.

Optional filtering

You can also filter results by url and/or enabled status, by passing these in as (optional) query parameters.

A Note about Postman Collections

If you have downloaded and imported this as a Postman Collection, you may find these optional query parameters have been selected with default values - which will probably not work.

If you are getting empty results back, check if these have been selected - and if they have, try again after deselecting them. You should then get back all your results, unfiltered.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter results by enabled status

\n","type":"text/plain"},"key":"enabled","value":"{boolean}"},{"description":{"content":"

Filter results by URL webhook data should be sent to

\n","type":"text/plain"},"key":"url","value":"{endpoint}"}],"variable":[]}},"response":[{"id":"25a49cde-ee80-4e1b-aff5-0439b38cc2ed","name":"List Webhooks","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.tallbob.com/v2/webhooks"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 16 Mar 2020 03:04:24 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 15,\n \"item_count\": 15,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 15,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"11a2f396-63f9-11ea-9458-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"clicktrack\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a46366-63f9-11ea-b26b-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"form_submission\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"119e82d4-63f9-11ea-8159-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"impression\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"1196fc6c-63f9-11ea-b2a5-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_delivered\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11987790-63f9-11ea-b470-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_delivery_error\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"119cfcde-63f9-11ea-a274-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_opened\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"119542c8-63f9-11ea-b689-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_polling\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"1199f976-63f9-11ea-86ae-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_pushed\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"119b7a3a-63f9-11ea-88d3-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"message_received\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a9239c-63f9-11ea-9785-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"scratchie_initiated\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11aaa1d6-63f9-11ea-9e87-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"scratchie_interact\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a00186-63f9-11ea-b78b-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"unsubscribe\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a17a16-63f9-11ea-9600-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"unsubscribe_track\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a74fae-63f9-11ea-838e-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"video_complete\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n },\n {\n \"id\": \"11a5d75a-63f9-11ea-ade0-06f848cc88f6\",\n \"name\": \"everything to Request bin\",\n \"enabled\": true,\n \"event_type\": \"video_play\",\n \"url\": \"https://ashwdj6j2gvn.x.pipedream.net\",\n \"headers\": null\n }\n ]\n}"},{"id":"1f9e595a-8591-4575-9824-0199cffeedb5","name":"Using URL","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tallbob.com/v2/webhooks?url=https://webhooks.r.us","host":["https://api.tallbob.com"],"path":["v2","webhooks"],"query":[{"key":"enabled","value":"{boolean}","description":"Filter results by enabled status","disabled":true},{"key":"url","value":"https://webhooks.r.us","description":"Filter results by URL webhook data should be sent to"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 17 Mar 2020 04:25:34 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 16,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"09ea3c1a-6726-11ea-9e34-067453a7f748\",\n \"name\": \"form values\",\n \"enabled\": false,\n \"event_type\": \"form_submission\",\n \"url\": \"https://webhooks.r.us\",\n \"headers\": []\n }\n ]\n}"},{"id":"eb542b8d-e636-4409-8e8a-f98275d48bb4","name":"Disabled Webhooks","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tallbob.com/v2/webhooks?enabled=false","host":["https://api.tallbob.com"],"path":["v2","webhooks"],"query":[{"key":"enabled","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 17 Mar 2020 04:22:02 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-RateLimit-Limit","value":"1900"},{"key":"X-RateLimit-Remaining","value":"1899"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"XMLHttpRequest, DNT, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Range"},{"key":"Access-Control-Expose-Headers","value":"Content-Length,Content-Range"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubdomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Served-By","value":"VC Supreme Overlord"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 16,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"id\": \"09ea3c1a-6726-11ea-9e34-067453a7f748\",\n \"name\": \"form values\",\n \"enabled\": false,\n \"event_type\": \"form_submission\",\n \"url\": \"https://webhooks.r.us\",\n \"headers\": []\n }\n ]\n}"}],"_postman_id":"f9f6c9ed-62db-40de-9d59-50b8fc8f0e19"},{"name":"Update Webhook","id":"3e98a03c-7cd5-4fc0-a315-2a5438b46e8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"url","value":"{string}","description":"

URL of your webhook (max length: 255)

\n","type":"text"},{"key":"event_type","value":"{string}","description":"

Event type (see above for valid event types)

\n","type":"text"},{"key":"enabled","value":"{boolean}","description":"

Boolean value to enable or disable webhook

\n","type":"text"},{"key":"name","value":"{string}","description":"

Name for the webhook

\n","type":"text"},{"key":"authorization","value":"{string}","description":"

Auth header if required to POST to your webhook

\n","type":"text"},{"key":"content-type","value":"{string}","description":"

Content Type header if default JSON type unsupported

\n","type":"text"}]},"url":"https://api.tallbob.com/v2/webhooks/{webhook_id}","description":"

You can update an existing webhook using this endpoint - your webhook ID must be present in the URL path.

Similar rules to the Create method apply, except there are no required parameters.

Header Parameters

You can update existing header configurations for your webhook and you can also remove a header by setting the value to null.

Retrieve details about a specific webhook using this endpoint - your webhook ID must be present in the URL path.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

For more information about webhooks, please see our documentation.

\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"1e73e079-c4c6-4a31-93c7-820574bd671a"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"84e49bb2-d3f8-4dbc-88bd-11066695d995"}}],"_postman_id":"46fc7ec5-acf0-41fa-97a0-5e0854ebcc47","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}},{"name":"Account","item":[{"name":"Create Account","id":"cc544797-81e2-48f5-8c70-30448edecf98","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"account_name","value":"{string}","description":"

Name of the account to be created

\n","type":"text","uuid":"ade9f159-00cc-4311-8458-1be974919aa9"}]},"url":"https://api.tallbob.com/v2/account/create","description":"

Post data to create a new account with details provided. Upon successful creation, details of your new account will be returned - including the Tall Bob Api auth_token, which is used for authentication.

Required Parameters

Every request must contain a account_name value, representing the account's name. Parameter cannot contain an empty value.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Success Response

A successful response will have an HTTP STATUS of usual 200 and will return a newly created account object, along with its own auth_token

Get the current balance of your account using this endpoint.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

List of accounts created via Api for your account, by request. You can send a request and retrieve your list at a time that suits you, using this endpoint.

Optional filtering

You can also filter results by enabled status, by passing these in as (optional) query parameter.

Please refer to HTTP STATUS CODES for definitions of response status codes for this request.

Filter results by enabled status

\n","type":"text/plain"},"key":"enabled","value":"{boolean}"}],"variable":[]}},"response":[{"id":"180e90c2-9a59-44c5-a0d1-4389fa86671c","name":"All Accounts","originalRequest":{"method":"GET","header":[],"url":"https://api.tallbob.com/v2/account/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 2,\n \"item_count\": 2,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 2,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"api_key\": \"your password for API requests related to this account\",\n \"date_created\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"date_updated\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"account_name\": \"Tallbob\",\n \"status\": \"disabled\",\n \"account_id\": \"11a2f396-63f9-11ea-9458-06f848cc88f6\",\n \"username\": \"your API username\",\n \"password\": \"your API password\"\n },\n {\n \"api_key\": \"your password for API requests related to this account\",\n \"date_created\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"date_updated\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"account_name\": \"Tallbob\",\n \"status\": \"enabled\",\n \"account_id\": \"11a2f396-63f9-11ea-9458-06f848cc88f6\",\n \"username\": \"your API username\",\n \"password\": \"your API password\"\n }\n ]\n}"},{"id":"75db766e-e2b7-4b75-bef4-28c5691059e1","name":"Disabled Accounts","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/account/list?enabled=false","host":["https://api.tallbob.com"],"path":["v2","account","list"],"query":[{"key":"enabled","value":"false"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 1,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"api_key\": \"your password for API requests related to this account\",\n \"date_created\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"date_updated\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"account_name\": \"Tallbob\",\n \"status\": \"disabled\",\n \"account_id\": \"11a2f396-63f9-11ea-9458-06f848cc88f6\",\n \"username\": \"your API username\",\n \"password\": \"your API password\"\n }\n ]\n}"},{"id":"4fd89dc6-75e0-4f9d-a5f1-8c6abf4e3e94","name":"Enabled Accounts","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.tallbob.com/v2/account/list?enabled=true","host":["https://api.tallbob.com"],"path":["v2","account","list"],"query":[{"key":"enabled","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"total\": 1,\n \"item_count\": 1,\n \"current_page\": 1,\n \"per_page\": 50,\n \"first_item\": 1,\n \"last_item\": 1,\n \"prev_page_url\": null,\n \"next_page_url\": null,\n \"data\": [\n {\n \"api_key\": \"your password for API requests related to this account\",\n \"date_created\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"date_updated\": \"YYYY-MM-DD HH:mm:ssZ\",\n \"account_name\": \"Tallbob\",\n \"status\": \"enabled\",\n \"account_id\": \"11a2f396-63f9-11ea-9458-06f848cc88f6\",\n \"username\": \"your API username\",\n \"password\": \"your API password\"\n }\n ]\n}"}],"_postman_id":"77f60a5a-8608-4a85-9126-92c349c74af1"},{"name":"Update Account","id":"745ff9c6-72d1-417e-b616-a901af04b85e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"formdata","formdata":[{"key":"status","value":"{string}","description":"

enabled|disabled

\n","type":"text","uuid":"608fdc19-c4f6-4187-a979-6ee08bbfcd00"}]},"url":"https://api.tallbob.com/v2/account/{account_id}","description":"

You can update an existing account using this endpoint - the account ID must be present in the URL path.

Important

Before attempting to use the Account Management APIs please ensure it is enabled on your account, you can do so by contacting your Account Manager.

For detailed information regarding this endpoint, please refer to our support documentation here

\n","_postman_id":"eee5528b-0594-4ae7-bbf8-91871e8df94e","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]},"isInherited":true,"source":{"_postman_id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","id":"458526fe-aee8-4682-bc3d-cfb5ef8cda00","name":"Tall Bob API V2","type":"collection"}}}],"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{api_username_env}}"},{"key":"password","value":"{{api_key_env}}"}]}},"event":[{"listen":"prerequest","script":{"id":"b616d893-4f66-47ac-8840-ff48ccc2a503","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c3cd6109-c291-4b62-810f-a8f58b13f70b","type":"text/javascript","exec":[""]}}],"variable":[{"key":"api_username","value":"Your API Username from the platform"},{"key":"api_key","value":"Your API Key from the platform"},{"key":"auth_value","value":"Basic YOUR_TOKEN"},{"key":"campaign_id","value":"{campaign_id}"},{"key":"after","value":""},{"key":"before","value":""},{"key":"to","value":"61499000100"},{"key":"send_ref","value":"ZZZ999"},{"key":"from","value":"TallBob"},{"key":"recipient1","value":"61499000100"},{"key":"recipient2","value":"61499000111"},{"key":"recipient3","value":"61499000222"},{"key":"mobile","value":"+61499000100"},{"key":"longcode","value":"61412123123"},{"key":"URL","value":"https://api.tallbob.com"}]}