MepMail Docs
API referenceEndpointsContacts

List contacts

GET
/contacts

Lists the team's contacts one page at a time.

AuthorizationBearer <token>

An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.

In: header

Query Parameters

limit?integer

Page size, 1-100 (default 20)

Range1 <= value <= 100
after?string

Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.

Formatuuid
before?string

Cursor: id of the first item of the next page (page backwards); same rule as after.

Formatuuid
include?string

MepMail extension: comma-separated facets attached to every item — properties (the {type, value} map GET /contacts/{id} returns) and topics (the rows GET /contacts/{id}/topics returns). Omitted, each item has the Resend shape.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/contacts"
{  "object": "list",  "data": [    {      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",      "email": "customer@example.com",      "first_name": "Ana",      "last_name": "Silva",      "created_at": "2026-10-19T12:00:00.000Z",      "unsubscribed": false,      "properties": {},      "topics": [        {          "id": "faccb7a5-8a28-4e9a-ac64-8da1cc3bc1cb",          "name": "Order updates",          "description": "Shipping and delivery updates",          "subscription": "opt_in",          "explicit": false,          "visibility": "public"        }      ]    }  ],  "has_more": false}