Customer attributes

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Customer attributes is a cluster API method that can be used to retrieve customer's aggregations, expressions, IDs, predictions, properties, recommendations, or segmentations.

It takes in an array of attribute objects. The attribute "type" will define what type of customer attribute you want to retrieve, e.g. a segmentation, or customer properties.

You will find the definitions for these different possible objects below.

Definition

Authorization

In this API call you must use the following type of authorization accesses:

Available access typesPermissions needed
Private accessVaries per method, see specific definitions below

Read more about:

Path parameters

ParameterTypeDescriptionRequired
projectTokenstringThe ID of your project.Required

Body parameters

ParameterTypeDescriptionRequired
customer_idsobjectOne or more hard and/or soft customer IDs are required. The most common ones include: registered.At least 1 required.
attributesArray of objects

Array of attribute objects that specify properties to be retrieved.

See below for available attribute object types and JSON code examples.

Required

Headers

ParameterTypeDescriptionRequired
authorizationstringUsed for authentication. Read more in the Authentication section.Required
content-typestringapplication/jsonRequired

Additional payload example

{
 "customer_ids": {
  "cookie": "382d4221-3441-44b7-a676-3eb5f515157f"
 },
 "attributes": [
  {
   "type": "property",
   "property": "first_name"
  },
  {
   "type": "property",
   "property": "last_name"
  },
  {
   "type": "segmentation",
   "id": "592ff585fb60094e02bfaf6a"
  },
  {
    "type": "id",
    "id": "registered"
  }
 ]
}
Path Params
string
required
Defaults to 12345678-1234-1234-1234-123456789abc
Body Params
customer_ids
object
required
attributes
array of objects
required
attributes*
Headers
string
required
Defaults to Basic <KeyID/Secret>
Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

© Bloomreach, Inc. All rights reserved.