📋 Get a Email List

The Get List endpoint retrieves details about a specific Email list.

📌 Endpoint

GET /fetch/list/:id/?count={Number_of_subs}&page={Page_of_subs}

🔑 Authentication

Include your API key in the request header:

EL_API_KEY: YOUR_SECRET_API_KEY

🔤 Query Parameters

Parameter	Type	Required	Description
`id`	String	✅ Yes	The unique email list id
`count`	Number	❌ No	The amount of subscribers to receive with the list data. (max: `25`) -> defaults to `5`
`page`	Number	❌ No	The page of the selected subscribers -> defaults to `1`

✅ Successful Response

{
	"error": null,
	"message": "Fetched list successfully",
	"ok": true,
	"totalPages": 2,
	"totalItems": 46,
	"list": {
		"name": "Testing waitlist",
		"description": "Test Descripton for waitlist in testing purposes. New settings page test",
		"id": "waitlist_39faa295-dbc7-4bcd-b179-c0fe55ff4d7d",
		"status": "Live",
		"maximumSignups": 100,
		"createdAt": "2025-03-14T19:16:24.798Z"
	},
	"subscribers": []
}

🔄 Returned Fields

Field	Description
`totalItems`	Total amount of subscribers in given list
`totalPages`	Total amount of pages in given list
`list`	Information about given list
`subscribers`	`count` amount of subscribers on page `page` of given list

For further API details, check out the API Reference.

Get

📋 Get a Email List

📌 Endpoint

🔑 Authentication

🔤 Query Parameters

✅ Successful Response

🔄 Returned Fields

On this page