MillionSend Docs

Read contacts in bulk

POST
/contacts/batch/get

MillionSend 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.

Request Body

application/json
  1. body
contacts*array<>

Up to 1000 contacts, each by id or by email address (matched case-insensitively)

Items1 <= items <= 1000
include?array<>

Facets to attach to every contact returned: properties and/or topics

Response Body

The contacts found, and the entries that matched none

application/json
  1. response
object*"list"
Value in"list"
data*array<>

The contacts found, in request order

missing*array<>

Request entries that matched no contact of the team

Example Request
curl -X POST 'https://api.millionsend.com/contacts/batch/get' \  -H 'Content-Type: application/json' \  -d '{  "contacts": [    {}  ]}'
Example Response
{  "object": "list",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "email": "string",      "first_name": "string",      "last_name": "string",      "created_at": "string",      "unsubscribed": true,      "properties": {        "property1": {          "type": "string",          "value": "string"        },        "property2": {          "type": "string",          "value": "string"        }      },      "topics": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "description": "string",          "subscription": "opt_in",          "explicit": true,          "visibility": "public"        }      ],      "object": "contact"    }  ],  "missing": [    {      "index": 0,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "email": "string"    }  ]}