beehiiv Developer Documentation

Currently in beta

Newsletter Lists is currently in beta, the API is subject to change.

Retrieve a single newsletter list belonging to a specific publication.

<Note title="Currently in beta" icon="b"> Newsletter Lists is currently in beta, the API is subject to change. </Note> Retrieve a single newsletter list belonging to a specific publication.

1	{
2	"data": {
3	"id": "nl_list_00000000-0000-0000-0000-000000000000",
4	"name": "Weekly Digest",
5	"slug": "weekly-digest",
6	"status": "active",
7	"auto_subscribe": false,
8	"subscriber_count": 100,
9	"created_at": 1672531200,
10	"updated_at": 1672531200,
11	"description": "A weekly digest of the best content."
12	}
13	}

1	curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/newsletter_lists/nl_list_00000000-0000-0000-0000-000000000000 \
2	-H "Authorization: Bearer <token>"

Currently in beta

Authentication

Path parameters

Response

Errors

Currently in beta