List OptOuts

This document will go over how to list all of your OptOut requests.

GET /addressbook/optout

List all of your OptOuts between two set dates.

Curl

curl -X GET \
"https://api.mobivatebulksms.com/addressbook/optout?startDate=2023-01-01&endDate=2023-01-02" \
-H 'Authorization: Bearer [API Key]'

Python

Retrieve 100 Optouts between 2023-01-01 00:00:00 (UTC) and 2023-01-02 00:00:00 (UTC).

Curl

curl -X GET \
"https://api.mobivatebulksms.com/addressbook/optout?startDate=2023-01-01&endDate=2023-01-02&pageSize=100" \
-H 'Authorization: Bearer [API Key]'

Python

Retrieve Opt-Outs between 2023-01-01 12:00:00 (AEST) and 2023-01-02 12:00:00 (AEST).

Curl

curl -X GET \
"https://api.mobivatebulksms.com/addressbook/optout?startDate=2023-01-01T12:00:00%2B1200&endDate=2023-01-02T12:00:00%2B1200" \
-H 'Authorization: Bearer [API Key]'

Python

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer [Api Key]

Body

Name	Type	Required?	Description
startDate	string	Yes	Start Date Format(s): YYYY-MM-DD YYYY-MM-DDTHH:MM:SS+TZ Examples: 2023-01-01 2023-01-01T00:00:00+0000 2023-01-01T00:09:00+0900.
endDate	string	Yes	End Date. Examples: See startDate.
page	integer	No	Page number. Default: 1.
pageSize	integer	No	Number of message records to return. Default: 10 Max: 1000.

Response

200

[
   {
      "id":1354505990,
      "mobile":"4400111222",
      "note":"MO",
      "created":1672704203000
   }
]

400

401

We use conventional HTTP response codes to indicate the success or failure of an API request. In general:

2xx indicate success 4xx indicate an error that failed given the information provided (e.g., a required parameter was omitted) 5xx errors indicate an error with ours servers (these are rare).

To see a full list of our Response codes, please click here.