MepMail Docs
API referenceEndpointsContactsBatchGet

Read contacts in bulk

POST
/contacts/batch/get

MepMail extension: returns up to 1000 contacts by id or by email address in one request, in request order, optionally with their properties and topic subscriptions. Entries that match no contact are listed under missing instead of failing the call. One call counts as one request against the rate limit.

AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/contacts/batch/get" \  -H "Content-Type: application/json" \  -d '{    "contacts": [      {        "email": "customer@example.com"      },      {        "id": "3f8a2c1e-5b7d-4e9f-a1c2-6d8e0f4b2a91"      }    ],    "include": [      "topics"    ]  }'
{  "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"        }      ],      "object": "contact"    }  ],  "missing": [    {      "index": 1,      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",      "email": "customer@example.com"    }  ]}