---
title: "Get contact lists"
method: GET
path: "/get-lists/"
tags: ["Lists"]
---

# Get contact lists

`GET /get-lists/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/get-lists/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

Get the contact lists for the account

## Query parameters

- `key` string, required
- `readonly` boolean

## Response `200`

Successfull response

- ListItem[]
  - `id` string: List ID. Values are numeric strings - the API emits this field as a JSON string, not a number
  - `created` integer: Unix timestamp the list was created
  - `name` string: List name
  - `readonly` boolean: Whether this is a system-managed readonly list (e.g. the Global Optout suppression list). Readonly lists are excluded from the response entirely unless the readonly parameter was set
  - `unsublist` boolean: Whether the list is used as an unsubscribe/suppression list
  - `count` integer: Number of contacts in the list

## Other responses

- `401`: Authentication failed or paramaters not provided

---

[API](https://skmtc.dev/smsfusion/apis/sms-fusion-api.md) · [All operations](https://skmtc.dev/smsfusion/apis/sms-fusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smsfusion/apis/sms-fusion-api/revisions/a88b2793a6e9?raw)