Skip to main content
GET
/
v1
/
lists
List mailing lists
curl --request GET \
  --url https://app.loops.so/api/v1/lists \
  --header 'Authorization: Bearer <token>'
[
    {
        "id": "clxf1nxlb000t0ml79ajwcsj0",
        "name": "Mailing List Beta",
        "description": null,
        "isPublic": true
    },
    {
        "id": "clxf2q43u00010mlh12q9ggx1",
        "name": "Product B Launch",
        "description": "Get pre-launch updates about Product B.",
        "isPublic": true
    }
]

​
Request

No parameters.

​
Response

This endpoint will return a list of mailing list objects. If your account has no mailing lists, an empty list will be returned.
​
Lists
array
[
    {
        "id": "clxf1nxlb000t0ml79ajwcsj0",
        "name": "Mailing List Beta",
        "description": null,
        "isPublic": true
    },
    {
        "id": "clxf2q43u00010mlh12q9ggx1",
        "name": "Product B Launch",
        "description": "Get pre-launch updates about Product B.",
        "isPublic": true
    }
]
Last modified on November 14, 2025