Skip to content Skip to navigation Skip to topbar

Get Batched Contacts by IDs

Operation overview

POST/v3/marketing/contacts/batch

Base url: https://api.sendgrid.com

This endpoint is used to retrieve a set of contacts identified by their IDs.

This can be more efficient endpoint to get contacts than making a series of individual GET requests to the "Get a Contact by ID" endpoint.

You can supply up to 100 IDs. Pass them into the ids field in your request body as an array or one or more strings.

Twilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Request body

SchemaExample

Property nameTypeRequiredDescriptionChild properties

idsarray[string]required

Responses

200401403404500

Schema

Property nameTypeRequiredDescriptionChild properties

resultarray[object]

Show child properties for result

Get Batched Contacts by IDs

Node.js

Python

Java

PHP

Ruby

curl


_24const client = require('@sendgrid/client');
_24client.setApiKey(process.env.SENDGRID_API_KEY);
_24
_24const data = {
_24  "ids": [
_24    "1234",
_24    "1235"
_24  ]
_24};
_24
_24const request = {
_24  url: `/v3/marketing/contacts/batch`,
_24  method: 'POST',
_24  body: data
_24}
_24
_24client.request(request)
_24  .then(([response, body]) => {
_24    console.log(response.statusCode);
_24    console.log(response.body);
_24  })
_24  .catch(error => {
_24    console.error(error);
_24  });