API FAQ

Which port and addresses do the API use?

If you restrict external traffic on your internet connection (using a firewall for instance) you might have troubles reaching our services. Our API is only accessible through HTTPS using two main IPs 185.76.20.140/30 and 185.76.22.140/30 on TCP port 443. (doc)

Where are the lists?

While using the API, you will notice various items identified by hash IDs, such as media, addressbooks, blacklists, campaigns, or SMS.

For these items, list methods are progressively discontinued if they ever existed. We strongly encourage you to build your applications with search methods instead. If you need to fetch a list of all items in a given category, you can always do a search query with empty parameters.

Here is an example of an addressbook search using the sendr/10/addressbook.search method (doc) with empty parameters to get a list of all address books.

Python

Ruby

NodeJS

What are jobs?

Asynchronous tasks (such as media uploads or exports) generate a job identified by a job ID (hash). Jobs help you keep track of the task and check for its completion. With the ID, you can get updates on a job or cancel them (doc).

Status on job can be pushed using the 'job.status_update' webhook. Check our article on webhooks for more information.