API referenceEndpointsContacts
List contacts
Lists the team's contacts one page at a time.
Authorization
apiKey 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)
Range
1 <= value <= 100after?string
Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.
Format
uuidbefore?string
Cursor: id of the first item of the next page (page backwards); same rule as after.
Format
uuidinclude?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}