1. REST API for Oracle Commerce Cloud 21C
  2. Tasks
  3. Agent
  4. Customers

searchProfiles

get

/ccagent/v1/profiles

Search Profiles. Get profiles by the search criteria entered. The search criteria include First Name, Last Name, Email, Postal Code, Phone Number .

Request

Supported Media Types
Query Parameters
  • This controls which fields are returned in the response body. Applicable when queryFormat=SCIM
  • This is the field to specify the number of records to be fetched per REST call. Applicable when queryFormat=SCIM
  • This field specifies the offset/starting index from which data to be fetched. Applicable when queryFormat=SCIM
  • Search criteria - Following are the fields supported by this param: |Field|Type|Description| |------------------|------------------|------------------| |firstName|string|First name of the profile| |lastName|string|Last name of the profile| |phoneNumber|string|The phone Number of the shipping address.| |pageNumber|integer|The page number for pagination| |postalCode|string|The postal Code of the shipping address| |limit|integer|The batch size of the order records to be fetched together.| |email|string|email of the profile| Search criteria in SCIM Format should be as: firstName co "Kim". Searching with custom properties: For Text Search, add prefix "dynProps_" (case sensitive) to the name of custom property being searched. For example: For a custom property with name as isVipCustomer, use search criteria field as dynProps_isVipCustomer. For SCIM Search, use the custom property name as the search criteria field without any prefix. For example: For a custom property with name as isVipCustomer, use search criteria field as isVipCustomer.
  • Should be SCIM if we are searching using SCIM query format
  • This field specifies the sort order of the list to be fetched. Applicable when queryFormat=SCIM
  • Indicates if the total results should be included in the response. Applicable when queryFormat=SCIM
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : searchProfiles_response
Type: object
Show Source
Nested Schema : items
Type: array
List of customer profiles. SCIM query response contains this property.
Show Source
Nested Schema : profileList
Type: array
List of profiles. Non-SCIM query response contains this property.
Show Source
Nested Schema : sort
Type: array
An array that specifies the sort order. SCIM query response contains this property.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : parentOrganization
Type: object
The parent Organization associated with the B2B customer profile.
Show Source
Nested Schema : secondaryOrganizations
Type: array
The secondary organizations associated with the B2B customer profile.
Show Source
Nested Schema : shippingAddress
Type: object
Default shipping address of the profile (Deprecated, please use ???shippingAddresses??? instead).
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : profileDetail
Type: object
Details of the customer profile
Show Source
Nested Schema : shippingAddress
Type: object
Default shipping address of the profile (Deprecated, please use ???shippingAddresses??? instead).
Show Source
Nested Schema : items
Type: object
Show Source
  • Whether this property should be sorted ascending ("asc") or descending ("dsc"). SCIM query response contains this property.
  • The name of the property to use for sorting. SCIM query response contains this property.
Example Response (application/json)
{
    "profileList":[
        {
            "profileDetail":{
                "firstName":"Kim",
                "lastName":"Anderson",
                "customerContactId":"CRMID_1",
                "repositoryId":"se-570031",
                "shippingAddress":{
                    "externalAddressId":"EXT_ADDR_1",
                    "phoneNumber":"212-555-1977",
                    "postalCode":"13202",
                    "repositoryId":"se-980031"
                },
                "id":"se-570031",
                "parentOrganization":null,
                "email":"kim@example.com"
            },
            "numberOfOrders":43,
            "latestOrderId":"o10042",
            "hasIncompleteOrder":false
        }
    ],
    "hasMore":false,
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccagentui/v1/profiles?q=%7BfirstName=kim%2ClastName=%22%22%2Climit=20%2CpageNumber=0%2CrequireCount=false%7D"
        }
    ],
    "totalNoOfProfiles":1
}

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: Below is the list of error codes specific to Text Search: |Error Code|Description| |------------------|------------------| |100001|Search client internal error.| |100002|Invalid date format| |100003|No pagination info passed in the search reuqest.| |100004|Invalid search criteria passed in search request.| |100006|Invalid boolean value.| |100013|Text search configuration is not enabled. Please enable text search to fetch the records |300001|Internal error occurred while performing search operation| |300002|One or more properties entered in the search criteria are invalid| |300003|One or more properties entered in the search criteria are not accessible by the Agent user| |300004|The property types of multiple dynamic properties entered in a single search criteria are not compatible with each other| Below is the list of error codes specific to SCIM Search: |Error Code|Description| |------------------|------------------| |85003|Invalid attribute in query
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top