LinkedIn contact info

mc.api.get_li_contact_info(["1000000001", "1000000002"])

Pass LinkedIn member IDs (the numeric ID, not the URL); get back ranked contact info per ID.

Parameters

records

list[str]

required

LinkedIn member-id strings (1–500).

version

str

default:"\"v2\""

API version. "v1" is also accepted.

presence_only

bool

default:"False"

v2 only — return presence flags instead of the contact values themselves. Useful for quickly checking how much you’d get from a full lookup before spending the credit.

dry_run

bool

default:"False"

Validate input locally without sending.

Response shape

result = mc.api.get_li_contact_info(["1000000001"])
# {
#   "results": [
#     {
#       "li_member_id": "1000000001",
#       "emails": [{"email_rank": 1, "email_address": "..."}, ...],
#       "phones": [...],
#       ...
#     }
#   ]
# }

The response is the raw API JSON (a dict) rather than a typed pydantic model — the shape is forward-compatible, so new fields the server adds don’t break older clients.

`presence_only` (v2)

When True, the response returns presence flags rather than values:

mc.api.get_li_contact_info(["1000000001"], presence_only=True)
# Returns "this member has 2 emails, 1 phone" rather than the values themselves.

Validation

dry_run=True returns the validated LiContactInfoRequest without sending; an empty records list (or > 500 entries) raises MinervaValidationError locally. See Validation.

Getting started

Endpoints

Power features

Reference

Parameters

Response shape

`presence_only` (v2)

Validation

​Parameters

​Response shape

​presence_only (v2)

​Validation

Parameters

Response shape

`presence_only` (v2)

Validation