» Lists » Lists » Get

GET lists

Retrieves the user's lists

Resource

Method GET
URL http://api.responder.co.il/v1.0/lists

Parameters

list_ids
optional

A comma separated list of List IDs to be retrived.
Invalid ID's will be returned in a JSON array of "INVALID_LIST_IDS"
NOTE! when used with "limit" or "offset" results are unpredictable

Example value: 123456,456
limit
optional

Maximum number of rows to be retrived.
Range between 1 to 500.

Example value: 25
Default value: 500
offset
optional

The position to start the count of "limit" from.
Value must be larger or equal to 0

Example value: 10
Default value: 0
dir
optional

The order of the rows.
For "dir=0" the rows will be in ascending order according to creation date.
For "dir=1" the rows will be in descending order according to creation date.
Value can be either 0 or 1

Example value: 1
Default value: 0
subscriber_id
optional

The identity of specific subscriber.
Value can be either id or email

Example value: 123456 Another example value: israeli@gmail.com
Default value: null
min_join_date
optional

The minimum for subscription date of subscriber.
Value has to be a valid date in YYYY-MM-DD HH:mm format

Example value: 2015-01-01 00:00
Default value: null
max_join_date
optional

The maximum for subscription date of subscriber.
Value has to be a valid date in YYYY-MM-DD HH:mm format

Example value: 2018-06-30 00:00
Default value: null

Example

GET http://api.responder.co.il/v1.0/lists

Response

{
   "LISTS" : [
      {
         "ID" : 123456,
         "DESCRIPTION" : "The List",
         "REMOVE_TITLE" : "Bye Bye!",
         "SITE_NAME" : "Responder!",
         "SITE_URL" : "http://www.esponder.co.il",
         "LOGO" : "http://www.responder.co.il/images/wn_06.gif",
         "SENDER_NAME" : "Someone",
         "SENDER_EMAIL" : "someone@responder.co.il",
         "SENDER_ADDRESS" : "Somewhere At Responder",
         "NAME" : "english_name",
         "AUTH_MAIL_SUBJECT" : "",
         "AUTH_MAIL_BODY" : "",
         "AUTH_MAIL_LINK" : "",
         "AUTH_MAIL_DIR" : "",
         "AUTH_MAIL_PAGE" : "",
         "AUTH_MAIL_FORM" : "",
         "AUTH_MAIL_MANUAL" : "",
         "EMAIL_NOTIFY" : {
            "first@responder.co.il",
            "second@responder.co.il"
         },
         "AUTOMATION" : {
            123457 : "First List",
            123458 : "Another List"
         }
      }
   ],
   "INVALID_LIST_IDS" : [456]
}