Get all Contact Lists

Get all contact lists existing in your account

get

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Query parameters

searchstringOptional

Filter contact lists by name (case-insensitive prefix match).

Example: news

Responses

200

OK.

application/json

idintegerOptional

namestring · max: 255Optional

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

429

Rate limit exceeded for the current account.

application/json

500

Internal error. Retry later or contact support.

application/json

get/api/contacts/lists

curl -X GET https://mailtrap.io/api/contacts/lists \
  -H 'Authorization: Bearer YOUR_API_KEY'

# Filter lists by name (case-insensitive prefix match)
curl -X GET 'https://mailtrap.io/api/contacts/lists?search=news' \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": 26730,
    "name": "Customers"
  },
  {
    "id": 26731,
    "name": "Old Contacts"
  }
]