Email Opt In/Out Lookup

Summary

This service returns Opt In/Out information stored for a given customer.

Base Resource URI

Production: https://ows.omeda.com/webservices/rest/brand/{brandAbbreviation}/filter/email/{emailAddress}/*

Testing: https://ows.omedastaging.com/webservices/rest/brand/{brandAbbreviation}/filter/email/{emailAddress}/*

brandAbbreviation

is the abbreviation for the brand

emailAddress

is the email address you are searching for

Technical Requirements

The HTTP header must contain the following elements:

x-omeda-appid

a unique id provided to you by Omeda to access your data. The request will fail without a valid id.

content-type

a content type supported by this resource. See Supported Content Types for more details. If omitted, the default content type is application/json.

Supported Content Types

There are three content types supported. If omitted, the default content type is application/json.

JSON

application/json

JSON is the preferred data exchange format, because it is lightweight and, in most cases, faster to process and utilizes less bandwidth. There are many available open-source JSON libraries available. See json.org for details.

Supported HTTP Methods

There is one HTTP method supported:

GET

See W3C’s GET specs for details.

Field Definition

The following tables describe the hierarchical data elements.

ResponseInfo Elements

Filters Elements

Response Examples

The possible HTTP response codes are as follows:

200

success

400

bad request

404

nothing found

500

internal server error

Successful Response (HTTP 200)

In these examples, the email address test4@omeda.com is opted in deployment types 42432 and 480643, and it is opted out of deployment type 528143.

JSON Example

{
   "Filters":[
      {
         "Source":"Optin API 2",
         "DeploymentTypeId":42432,
         "Status":"IN",
         "Brand":"XXM",
         "CreatedDate":"2010-12-15 11:10:05 CST",
         "ChangedDate":"2010-12-15 11:10:05 CST"
      },
      {
         "Source":"Optin API 2",
         "DeploymentTypeId":480643,
         "Status":"IN",
         "Brand":"XXZ",
         "CreatedDate":"2010-12-15 11:10:05 CST",
         "ChangedDate":"2010-12-15 11:10:05 CST"
      },
      {
         "Source":"Optin API 2",
         "DeploymentTypeId":528143,
         "Status":"OUT",
         "Brand":"XXP",
         "CreatedDate":"2010-12-15 11:10:05 CST",
         "ChangedDate":"2010-12-15 11:10:05 CST"
      }
   ],
   "EmailAddress":"test4@omeda.com",
   "Submission":"7fe70124-14c9-4210-8dbc-e2beac44a203"
}

Error Response (HTTP 404)

In these examples, no Opt-In nor Opt-Outs are found for the email address test4@omeda.com

JSON Example

{
   "Submission":"C961641F-EA94-4DAA-80E4-6B44F13DA8BE",
   "Errors":[
      {
         "Error":"There are no opt-ins/opt-outs for test4@aomeda.com"
      }
   ]
}