Use an email address to retrieve a member ID
The best way to check for the existence of a single member by email address is to use the following request:
| API request format |
|---|
| If | Then |
|---|---|
| A member ever used this email address | One item is returned. |
| No member has ever had this email address | Then an empty collection is returned. |
Note: The resource
/membervalues should be used rather than
/membervalues/asof/{datetime}, because the email address
for a member can change over time. Using
/membervalues/asof/{datetime} would miss cases where the
email address in the request is not the latest.
For more information, see /membervalues.
Content control
The following parameters are not required, but reduce the amount of information returned:
| Parameter | Description |
|---|---|
fields=memberid
|
Reduces the number of properties returned to the bare minimum. |
sort=effectivedate:d&limit=1
|
Sorts items by effective date in descending order and reduces the number of items returned to 1 (where there could be more than one if the email address had been set multiple times). |