Lists

Get all lists

GEThttps://api.smsedge.com/v1/lists/getall/

Returns all your contact lists, newest first.

Deleted lists are not returned. If your account has no lists, the API creates an empty list named My List and returns it.

This endpoint does not return number counts. To get the counts for one list, use Get list info.

This endpoint has no parameters besides your API key.

Responses

  • 200Your lists, newest first.
  • 401The API key is missing or not valid.
curl -X GET "https://api.smsedge.com/v1/lists/getall/" \
  -H "X-API-KEY: YOUR_API_KEY"
[
  {
    "success": true,
    "data": [
      {
        "id": 347617,
        "name": "UK customers",
        "description": null,
        "status": "Finished",
        "created": "2026-08-12 22:08:33"
      },
      {
        "id": 337711,
        "name": "Newsletter",
        "description": "Signed up on the website",
        "status": "Finished",
        "created": "2026-04-20 08:41:50"
      }
    ],
    "errors": [],
    "response": {
      "code": 200,
      "description": "OK",
      "date": "2026-11-16 13:58:51"
    },
    "api": {
      "version": "v1",
      "module": "lists",
      "function": "getall"
    },
    "user": {
      "id": 12345
    }
  }
]

All requests need your API key in the X-API-KEY header. See Authentication.