AIairship
Email

Look up an email address

Changed on

Returns a channel by email address. For security, email addresses are one-way hashed and aren't returned when you look up a channel by ID. Use this endpoint to find a channel belonging to a particular email address.

You may need to escape the @ character in URLs using%40.

get/api/channels/email/{email}

Request

Path parameters

emailstring required
Example:name@example.com

The email address of the channel you want to look up.

Response

A channel exists for the email address

okboolean

Success.

Example response

{
  "channel": {
    "address": "email@example.com",
    "channel_id": "9c36e8c7-5a73-47c0-9716-99fd3d4197d5",
    "email_address": "name@example.com",
    "ios": {
      "quiettime": {
        "end": "07:30",
        "start": "21:30"
      },
      "tz": "America/Los_Angeles"
    },
    "msisdn": "15035556789",
    "named_user_id": "john_doe",
    "open": {
      "identifiers": {
        "slack-handle": "slackinator"
      },
      "open_platform_name": "Slack"
    },
    "opt_in_date": "2022-07-07T03:23:13",
    "opt_out_date": "2022-07-08T03:23:13",
    "push_address": "FE66489F304DC75B8D6E8200DFF8A456E8DAEACEC428B427E9518741C92C6660",
    "subscription_lists": [
      {
        "action": {
          "list_id": "90s_rap_videos"
        },
        "list_id": "90s_rap_videos"
      }
    ],
    "tags": [
      "Federer fan",
      "Messi fan"
    ]
  }
}

Changes

  • bd6ab947117aRevision changes
    • breaking

      added subschema #1: Channel subscription list action to the /// response property oneOf list for the response status

    This list may be incomplete.

  • 38241778b0c1Revision changes
    • warning

      removed the optional property / from the response with the status

    This list may be incomplete.