Lists
Get list info
GET
https://api.smsedge.com/v1/lists/info/Returns one list with its number counts for each country.
The counts array has one item for each country in the list. It is left out when the list has no numbers.
numbers_goodandnumbers_bad: numbers that passed or failed verification.numbers_clickers: numbers that clicked a link in one of your messages.numbers_sent: numbers that are ready to send.numbers_hlr_progress: numbers with an HLR check in progress.
Query params
idintegerrequiredID of the list. Get it from Get all lists.
Responses
- 200The list and its counts.
- 400The id parameter is missing.
- 404No list with this ID in your account, or the list was deleted.
curl -X GET "https://api.smsedge.com/v1/lists/info/?id=347617" \
-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",
"counts": [
{
"country_id": 225,
"country_name": "United Kingdom",
"numbers_total": 269,
"numbers_good": 0,
"numbers_bad": 4,
"numbers_clickers": 0,
"numbers_sent": 265,
"numbers_hlr_progress": 0,
"numbers_waiting": 265
}
]
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 13:59:02"
},
"api": {
"version": "v1",
"module": "lists",
"function": "info"
},
"user": {
"id": 12345
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.