Jump to: navigation, search

Query Customer Profile

Prerequisites: You need to enable profiles in UCS.
GET /profiles/${customer_id}


Queries the Customer Profile based on the customer ID parameter. According to the query's fields, your application can retrieve profile and extension attributes in addition to the identified customer ID. The response always contains all attributes of the customer profile resource, and all attributes of the specified extensions, to avoid ambiguity in further updates (see Update Customer Profile).

To get the schema of the profile and extension attributes, use the Query Profile Schema operation.


Prerequisites: A Customer Profile Schema (a list of Attribute Schema) is available.

Method GET
URL /profiles/${customer_id}
Field Name   Type   Mandatory Description
URI Parameters
${customer_id} string yes Specified in the URI, the ID of the customer.
extensions string no The list of extensions to return within the result. Your application can specify multiple extension names, separated with comas. For instance: extensions=contacts,purchases


The Context Management Service API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See [[HTTP Response Codes and Errors for further details on the possible codes that this operation can return.

HTTP code 200
HTTP message OK
Field Name   Type   Mandatory Description
Body: Customer Profile. The returned result contains parts of the profile or the complete profile according to the parameters of the request. See Customer Profile for further information on the resource.
customer_id string yes The unique ID of the given customer. Limited to 16 characters.
<attribute n>
  • string
  • datetime
yes Customer attributes, where <attribute n> is the attribute name. See the configuration options for further details. Attributes are not part of a separated array, see the example below.

The date/time formats are ISO 8601:[YYYY]-[MM]-[DD]T[HH]:[mm]:[ss].[SSS]Z.

<extension n> Extension
or Extension[]
no By default, no extension is returned. The returned extensions are specified in the parameters of the request. For further details, see Extension.

<references />


For example, the customer profile (id=0004Va58A92T0017) has three attributes: "name","birthdate" and "EmailAddress". This profile also has two defined extensions:

  • contacts: one or more phone numbers (a multi-valued extension).
  • preferences: a single-valued extension representing customer preferences for receiving a weekly newsletter, receiving notification of new offers, and the desired email type.


 GET /profiles/0004Va58A92T0017?extensions=contacts,preferences 


 200 OK
 { "customer_id": "0004Va58A92T0017 ", 
  "name": "Doe, John", 
  "birthdate": "1976-05-10",
  "EmailAddress": [
  "contacts": [
   {"phone": "408-555-1234", "ext": "1234"},
   {"phone": "408-832-7712"} ],
  "preferences": { "newsletter": "y", "new_offers": "n", "email": "html" } 
This page was last edited on April 27, 2017, at 10:19.
blog comments powered by Disqus