Subscribers

Find a contact in every list

GET /api/v1/subscribers/email/{email}

Every contact with this address, in the lists the token's user may read, each with the uid of its list.

Parameters
email string (email) required path
Responses
200 The contacts; empty when no list has the address.
401 The token is missing or wrong (Unauthenticated.), or its user may not act on this object (Unauthorized). Without the Accept: application/json header, a missing or wrong token answers with a redirect to the sign-in page instead.
Find a contact in every list
1 2 3
curl 'https://your-domain/api/v1/subscribers/email/anna@example.com' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
1 2
$client = new Acelle\Client('https://your-domain/api/v1', 'YOUR_API_TOKEN');
$client->subscriber()->findByEmail('anna@example.com');
Response
{
    "subscribers": [
        {
            "id": 1,
            "list_uid": "6adaabbf98847",
            "email": "anna@example.com",
            "status": "subscribed",
            "source": "signup",
            "ip_address": "203.0.113.24",
            "tags": [],
            "FIRST_NAME": "Anna"
        },
        {
            "id": 70756,
            "list_uid": "6adaabc2e15a9",
            "email": "anna@example.com",
            "status": "subscribed",
            "source": "admin",
            "ip_address": null,
            "tags": [
                "vip"
            ],
            "FIRST_NAME": "Anna"
        }
    ]
}