List Contact Lists

curl --request GET \
  --url 'https://api.autosend.com/v1/contact-lists?type=list' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.autosend.com/v1/contact-lists"

headers = {
    "Authorization": "Bearer <token>"
}

params = {
    "type": "list"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch('https://api.autosend.com/v1/contact-lists?type=list', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

<?php

$url = 'https://api.autosend.com/v1/contact-lists?type=list';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <token>'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.autosend.com/v1/contact-lists?type=list"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer <token>")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class ListContactLists {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.autosend.com/v1/contact-lists?type=list");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Authorization", "Bearer <token>");

            BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
            String inputLine;
            StringBuilder content = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                content.append(inputLine);
            }
            in.close();
            con.disconnect();

            System.out.println(content.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

require 'net/http'
require 'uri'

uri = URI('https://api.autosend.com/v1/contact-lists?type=list')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer <token>'

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "lists": [
      {
        "id": "GLOBAL_CONTACT_LIST",
        "name": "All Contacts",
        "description": "All contacts in the project",
        "type": "list",
        "contactCount": 1250
      },
      {
        "id": "60d5ec49f1b2c72d9c8b4567",
        "name": "Newsletter Subscribers",
        "description": "Users who signed up for the weekly newsletter",
        "type": "list",
        "contactCount": 340,
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-02-20T14:45:00.000Z"
      },
      {
        "id": "60d5ec49f1b2c72d9c8b9876",
        "name": "Active Users",
        "description": "Segment of users who opened an email in the last 30 days",
        "type": "segment",
        "contactCount": 890,
        "filterCriteria": {
          "logicalOperator": "AND",
          "groups": [
            {
              "field": "lastActivity",
              "fieldType": "date",
              "operator": "after",
              "value": "2026-02-17T00:00:00.000Z"
            }
          ]
        },
        "createdAt": "2026-02-01T08:15:00.000Z",
        "updatedAt": "2026-03-01T11:20:00.000Z"
      }
    ]
  }
}