Right to Access Requests

Overview

Extole supports GDPR/CCPA Right to Access requests through support tickets or through API. If you would like to get data about one of your customers, you can submit a support ticket to support@extole.com.

Alternatively you can use the following two APIs to retrieve information.

Search Person by Email

The Search Person endpoint can be used to retrieve basic profile information and device information, including IP/Geo.

GET https://my.extole.com/api/v2/persons?email=april%40advocate.com

Response

[
  {
    id: "7059776202829706264",
    email: "april@advocate.com",
    first_name: "April",
    last_name: "Advocate",
    partner_user_id: "15786548",
    parameters: {
      company: "Intuit",
      email_capture_acceptance: "true",
    },
    request_contexts: [
      {
        ip: "45.29.223.242",
        device_id: "browser:7059772997041655050",
        created_at: "2022-02-01T09:04:50.164-07:00",
        country: {
          iso_code: "US",
          name: "United States"
        },
        state: {
          iso_code: "TX",
          name: "Texas"
        },
        city: {
          name: "Katy"
        },
        location: {
          latitude: 29.8331,
          longitude: -95.7498
        }
      }
    ],
    locale: {
      last_browser: "en-US,en;q=0.9",
      user_specified: null
    } 
  }
]

Get Shares

The Get Shares endpoint gets the list of shares the advocate has made.

GET https://my.extole.com/api/v4/persons/7059776202829706264/shares

Response

[
  {
    "share_id": "6830397826523129124",
    "shareable_id": "6830394627794392942",
    "channel": "EXTOLE_EMAIL",
    "message": "Dummy message",
    "share_date": "2020-05-24T06:12:02.908-07:00",
    "recipient": "friend@example.com",
    "friend_person_id": "6830397828381759009",
    "link": "https://refer.brand.com/s/d6363t",
    "data": {
      "friend_first_name": "Julio",
    },
    "partner_id": null,
    "subject": null
  }
]

Get Friends

The Get Person's Friends endpoint gets the list of friend relationships for the advocate, including the reason the friend was connected to the advocate.

GET https://my.extole.com/api/v2/persons/7059776202829706264/friends

[
  {
    shareable_id: "7059775747513184808",
    reason: "ADVOCATE_CODE",
    container: "production",
    updated_at: "2022-02-01T09:57:46.55-07:00",
    person: {
      id: "7059776202829706264",
      email: "julio@friend.com",
      first_name: "Julio",
      last_name: "Friend",
      partner_user_id: null,
      parameters: {},
      request_contexts: [
        {
          ip: "45.29.223.242",
          device_id: "browser:7059772997041655050",
          created_at: "2022-02-01T09:04:50.164-07:00",
          country: {
            iso_code: "US",
            name: "United States"
          },
          state: {
            iso_code: "TX",
            name: "Texas"
          },
          city: {
            name: "Katy"
          },
          location: {
            latitude: 29.8331,
            longitude: -95.7498
          }
        }
      ],
      locale: {
        last_browser: "en-US,en;q=0.9",
        user_specified: null
      }
    }
  }
]