Skip to main content
GET
AhaSend Go SDK
The AhaSend API returns the account’s lists, newest first. Access requires lists:read. Each list has contact_count, the number of members that a campaign to it would reach. See Lists. name finds the lists whose names hold the value, in any case. %, _ and \ match as plain characters, not as wildcards. The API trims the value, so an empty value or one with only spaces returns all lists. Pages use cursors: send after or before, not both. See Pagination.

Authorizations

Authorization
string
header
required

API key for authentication. Non-empty Security Requirement values are AhaSend API-key roles. Roles listed within one requirement object are jointly required; separate requirement objects are alternatives.

Path Parameters

account_id
string<uuid>
required

Account ID

Query Parameters

limit
integer
default:100

Maximum number of lists to return

Required range: 1 <= x <= 100
after
string

Cursor for the next page; cannot be combined with before

before
string

Cursor for the previous page; cannot be combined with after

name
string

Case-insensitive substring match on the list name. %, _, and \ match literally rather than as wildcards. The value is trimmed before it is matched, so one that is empty or all whitespace filters nothing and the full collection is returned.

Response

Paginated lists

object
enum<string>
required
Available options:
list
data
object[]
required
pagination
object
required