getProfile
get
/ccappagent/v1/profiles/{id}
Get Profile. Get details of a customer profile. Optionally takes X-CCOrganization & x-ccsite header.
Request
Supported Media Types
- application/json
Path Parameters
-
id(required): string
The customer profile id.
Header Parameters
-
X-CCOrganization: string
The organization Id to which the profile belongs to
-
x-ccsite: string
the site id corresponding to which site specific properties should be shown
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : getProfile_response
Type:
Show Source
object
-
hasIncompleteOrder:
boolean
Indicates whether the profile has an incomplete order on the current site.
-
isAnonymous:
boolean
Indicates whether the profile is persistent or transient.
-
profileComments:
array profileComments
The list of all logged comments for the customer profile.
-
profileDetail:
object profileDetail
The details of the customer profile.
Nested Schema : profileComments
Type:
array
The list of all logged comments for the customer profile.
Show Source
Nested Schema : profileDetail
Type:
object
The details of the customer profile.
Show Source
-
active:
boolean
The user status of the profile. Should be true or false
-
approvalRequired:
boolean
Indicates if approval is required
-
catalog:
object catalog
The catalog associated with this profile.
-
comments:
array comments
The notes on the customer.
-
contactBillingAddress(required):
object contactBillingAddress
The default billing address for B2B contact.
-
contactShippingAddress:
object contactShippingAddress
The default shipping address for B2B contact
-
currentOrganization:
object currentOrganization
The current Organization
-
customerContactId:
string
The external customer contact id.
-
dateOfBirth:
string
Date of birth
-
daytimeTelephoneNumber:
string
The day time telephone number of the customer profile.
-
derivedTaxExemptionCode:
string
Derived Tax Exemption Code
-
dynamicProperties:
array dynamicProperties
Read-only list of dynamic properties associated with profile along with meta-data.
-
email:
string
Email of the customer profile.
-
firstName:
string
The first name of the customer profile.
-
GDPRProfileP13nConsentDate:
string
The date on which GDPR personalization consent was granted by the user.
-
GDPRProfileP13nConsentGranted:
boolean
Indicates whether the user has given GDPR Profile P13n consent on the current site. Can be true or false.
-
id:
string
The customer profile id.
-
lastName:
string
Last name of the customer profile.
-
locale:
string
Current Locale
-
login:
string
Login id of the profile.
-
loyaltyPrograms:
array loyaltyPrograms
Loyalty Programs Information
-
orderPriceLimit:
number
Order Price Limit of the profile
-
parentOrganization:
object parentOrganization
The parent Organization associated with the B2B customer profile.
-
priceListGroup:
object priceListGroup
The associated price list group for this profile
-
profileType:
string
The type of the user. Possible values are b2b_user and b2c_user.
-
receiveEmail:
string
Indicates whether the customer has opted for receiving marketing emails on the current site. Can be yes or no.
-
receiveEmailDate:
string
The date on which the customer opted for receiving marketing emails.
-
repositoryId:
string
The repository id of the customer profile record.
-
roles:
array roles
List of user roles.
-
secondaryAddresses(required):
object secondaryAddresses
Secondary addresses for B2B contact.
-
secondaryOrganizations:
array secondaryOrganizations
List of secondary organizations that need to associate with the user.
-
shippingAddress:
object shippingAddress
Default shipping address of the profile (Deprecated, please use ???shippingAddresses??? instead).
-
shippingAddresses:
array shippingAddresses
The shipping addresses associated with the customer profile.
-
taxExempt:
boolean
Indicates tax exemption status.True or False
-
taxExemptionCode:
string
Tax Exemption Code
Nested Schema : items
Type:
Show Source
object
-
comment:
string
The comment string.
-
creationDate:
string
The of creation date of the comment.
-
repositoryId:
string
The repository id of the comment record.
Nested Schema : catalog
Type:
object
The catalog associated with this profile.
Show Source
-
repositoryId:
string
RepositoryId of the catalog associated with this profile.
Nested Schema : comments
Type:
array
The notes on the customer.
Show Source
-
Array of:
object items
The info of the customer
Nested Schema : contactBillingAddress
Type:
object
The default billing address for B2B contact.
Show Source
-
address1:
string
Address line 1 for this billing address.
-
address2:
string
Address line 2 for this billing address.
-
address3:
string
Address line 3 for this billing address.
-
city:
string
City for this billing address.
-
companyName:
string
Company name for this billing address.
-
country:
string
Country for this billing address.
-
county:
string
County for this billing address.
-
dynamicProperty:
object dynamicProperty
The value of the dynamic Property
-
email:
string
Email for this billing address.
-
externalAddressId:
string
External address id
-
faxNumber:
string
Fax number for this billing address.
-
firstName:
string
First name for this billing address.
-
jobTitle:
string
Job title for this billing address.
-
lastName:
string
Last name for this billing address.
-
middleName:
string
Middle name for this billing address.
-
phoneNumber:
string
Phone number for this billing address.
-
postalCode:
string
Postal code for this billing address.
-
prefix:
string
Prefix for this billing address.
-
repositoryId:
string
The repository id of the billing address
-
state:
string
State for this billing address.
-
suffix:
string
Suffix for this billing address.
Nested Schema : contactShippingAddress
Type:
object
The default shipping address for B2B contact
Show Source
-
address1:
string
The address line 1 in the shipping address.
-
address2:
string
The address line 2 in the shipping address.
-
address3:
string
The address line 3 in the shipping address.
-
city:
string
The city in the shipping address record.
-
companyName:
string
Company name for this address.
-
country:
string
The country in the shipping address record.
-
county:
string
The county in the shipping address.
-
dynamicProperty:
object dynamicProperty
The value of the dynamic Property
-
externalAddressId:
string
External address id
-
faxNumber:
string
Fax number for this address.
-
firstName:
string
The first name in the shipping address.
-
jobTitle:
string
Job title for this address.
-
lastName:
string
The last name in the shipping address.
-
middleName:
string
Middle name for this address.
-
phoneNumber:
string
The phone number in the shipping address.
-
postalCode:
string
The postal code in the shipping address.
-
prefix:
string
Prefix for this address.
-
repositoryId:
string
The repository id of the shipping address record.
-
state:
string
The state in the shipping address.
-
suffix:
string
Suffix for this address.
Nested Schema : currentOrganization
Type:
object
The current Organization
Show Source
-
id:
string
The current Organization Id
Nested Schema : dynamicProperties
Type:
array
Read-only list of dynamic properties associated with profile along with meta-data.
Show Source
Nested Schema : parentOrganization
Type:
object
The parent Organization associated with the B2B customer profile.
Show Source
-
id:
string
The id of the organization.
-
name:
string
The name of of the organization.
-
punchoutUserId:
string
Punchout user Id of organization, read only property.
-
repositoryId:
string
The repository id of the comment record.
Nested Schema : priceListGroup
Type:
object
The associated price list group for this profile
Show Source
-
repositoryId:
string
Repository ID of the price list group
Nested Schema : secondaryAddresses
Type:
object
Secondary addresses for B2B contact.
Show Source
-
address1:
string
Address line 1 for this address.
-
address2:
string
Address line 2 for this address.
-
address3:
string
Address line 3 for this address.
-
city:
string
City for this address.
-
companyName:
string
Company name for this address.
-
country:
string
Country for this address.
-
county:
string
County for this address.
-
dynamicProperty:
object dynamicProperty
The value of the dynamic Property
-
email:
string
Email for this address.
-
externalAddressId:
string
External address id
-
faxNumber:
string
Fax number for this address.
-
firstName:
string
First name for this address.
-
jobTitle:
string
Job title for this address.
-
lastName:
string
Last name for this address.
-
middleName:
string
Middle name for this address.
-
phoneNumber:
string
Phone number for this address.
-
postalCode:
string
Postal code for this address.
-
prefix:
string
Prefix for this address.
-
repositoryId:
string
The repository id of this address.
-
state:
string
State for this address.
-
suffix:
string
Suffix for this address.
Nested Schema : secondaryOrganizations
Type:
array
List of secondary organizations that need to associate with the user.
Show Source
Nested Schema : shippingAddress
Type:
object
Default shipping address of the profile (Deprecated, please use ???shippingAddresses??? instead).
Show Source
-
address1:
string
The address line 1 in the shipping address.
-
address2:
string
The address line 2 in the shipping address.
-
address3:
string
The address line 3 in the shipping address.
-
alias:
string
The alias of the shipping address.
-
city:
string
The city in the shipping address record.
-
companyName:
string
Company name for this address.
-
country:
string
The country in the shipping address record.
-
county:
string
The county in the shipping address.
-
dynamicProperty:
object dynamicProperty
The value of the dynamic Property
-
externalAddressId:
string
External address id
-
faxNumber:
string
Fax number for this address.
-
firstName:
string
The first name in the shipping address.
-
jobTitle:
string
Job title for this address.
-
lastName:
string
The last name in the shipping address.
-
middleName:
string
Middle name for this address.
-
phoneNumber:
string
The phone number in the shipping address.
-
postalCode:
string
The postal code in the shipping address.
-
prefix:
string
Prefix for this address.
-
repositoryId:
string
The repository id of the shipping address record.
-
state:
string
The state in the shipping address.
-
suffix:
string
Suffix for this address.
Nested Schema : shippingAddresses
Type:
array
The shipping addresses associated with the customer profile.
Show Source
Nested Schema : items
Type:
object
The info of the customer
Show Source
-
agent:
string
The user id of the Agent.
-
comment:
string
The description of comment.
-
creationDate:
string
The creation date of the note.
-
id:
string
The id of the comment.
-
item-id:
string
The item-id of the comment
-
owner:
string
The owner of the note.
-
version:
integer
The version of the note.
Nested Schema : dynamicProperty
Type:
object
The value of the dynamic Property
Nested Schema : dynamicProperty
Type:
object
The value of the dynamic Property
Nested Schema : items
Type:
Show Source
object
-
id:
string
The ID of the dynamic property.
-
type:
string
The type of the dynamic property. Supported types are boolean, date, float, string, timestamp, enumerated, big string.
-
value:
string
The value of the dynamic property.
Nested Schema : items
Type:
Show Source
object
-
membershipId:
string
membershipId of the profile.
-
programId:
string
programId of Loyalty Program
-
programName:
string
programName of Loyalty Program
-
repositoryId:
string
repository Id
-
status:
string
status of Enrollment
Nested Schema : items
Type:
Show Source
object
-
associations:
array associations
Associations of the role.
-
function:
string
Function of the role which can be admin or buyer.
-
id:
string
ID of the role
-
name:
string
Name of the role
-
relativeTo:
string
OrganizationId in which the role applies. Present only if type is organizationalRole
-
repositoryId:
string
Repository id of the role.
-
type:
string
Type of the role which can be organizationalRole or role
Nested Schema : items
Type:
Show Source
object
- relatedItemId: string
-
type:
string
Type of the association.Possible values are - organization,global.
Nested Schema : dynamicProperty
Type:
object
The value of the dynamic Property
Nested Schema : dynamicProperty
Type:
object
The value of the dynamic Property
Nested Schema : items
Type:
Show Source
object
-
address1:
string
The address line 1 in the shipping address.
-
address2:
string
The address line 2 in the shipping address.
-
address3:
string
The address line 3 in the shipping address.
-
alias:
string
The alias of the shipping address.
-
city:
string
The city in the shipping address record.
-
companyName:
string
The company name of the person in the shipping address.
-
country:
string
The country in the shipping address record.
-
county:
string
The county in the shipping address.
-
dynamicProperty:
object dynamicProperty
The value of the dynamic Property
-
externalAddressId:
string
External address id
-
faxNumber:
string
The fax number in the shipping address.
-
firstName:
string
The first name in the shipping address.
-
isDefaultAddress:
boolean
Indicates if its the default shipping address.
-
jobTitle:
string
The job title of the person in the shipping address.
-
lastName:
string
The last name in the shipping address.
-
middleName:
string
The middle name in the shipping address.
-
phoneNumber:
string
The phone number in the shipping address.
-
postalCode:
string
The postal code in the shipping address.
-
prefix:
string
Prefix for this address.
-
repositoryId:
string
The repository id of the shipping address record.
-
selectedCountry:
string
The selected country in the shipping address.
-
selectedState:
string
The selected state in the shipping address.
-
state:
string
The state in the shipping address.
-
state_ISOCode:
string
The state ISO code in the shipping address.
-
suffix:
string
The suffix of the person in the shipping address
Nested Schema : dynamicProperty
Type:
object
The value of the dynamic Property
Example Response (application/json)
{
"profileDetail":{
"lastName":"Butt",
"GDPRProfileP13nConsentDate":"2018-03-21T13:10:08.463Z",
"customerContactId":"CRMID_12345",
"GDPRProfileP13nConsentGranted":true,
"catalog":{
"repositoryId":"cloudLakeCatalog"
},
"dynamicProperties":[
{
"id":"dynamicPropertyMaritalStatus",
"label":"Marital Status",
"type":"string",
"value":"Single"
}
],
"contactBillingAddress":{
"lastName":"Anderson",
"firstName":"Kim",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"212-555-2150",
"address2":null,
"city":"Buffalo",
"address1":"451 Brooks Ave",
"postalCode":"14201",
"county":null,
"repositoryId":"se-990031",
"state":"NY"
},
"receiveEmail":"yes",
"dateOfBirth":"2001-11-14T00:00:00.000Z",
"secondaryAddresses":{
"Work":{
"lastName":"Anderson",
"firstName":"Kim",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"212-555-2150",
"address2":null,
"city":"Buffalo",
"address1":"451 Brooks Ave",
"postalCode":"14201",
"county":null,
"repositoryId":"se-970031",
"state":"NY"
},
"Mom' s house":{
"lastName":"Anderson",
"firstName":"Dolores",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"212-555-4321",
"address2":null,
"city":"Dewitt",
"address1":"41 Wexford Rd ",
"postalCode":"13214",
"county":null,
"repositoryId":"se-140010",
"state":"NY"
},
"Home":{
"lastName":"dd",
"firstName":"sdf",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"1231231231",
"address2":"f",
"city":"f",
"address1":"dd",
"postalCode":"36123",
"county":null,
"repositoryId":"se-980031",
"state":"AL"
}
},
"locale":"en_US",
"contactShippingAddress":{
"lastName":"dd",
"firstName":"sdf",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"1231231231",
"address2":"f",
"city":"f",
"address1":"dd",
"postalCode":"36123",
"county":null,
"repositoryId":"se-980031",
"state":"AL"
},
"parentOrganization":{
"name":"Oracle India Pvt Ltd",
"repositoryId":"oracle",
"punchoutUserId":"100012",
"id":"oracle"
},
"receiveEmailDate":"2018-03-21T13:10:08.463Z",
"firstName":"James",
"profileType":"b2b_user",
"loyaltyPrograms":[
{
"programName":"XTRAREWARDS",
"membershipId":"abc123",
"programId":"prog1",
"status":"Enrolled"
},
{
"programName":"XTRAREWARDS",
"membershipId":"xyz123",
"programId":"prog2",
"status":"RequestForEnrollment"
}
],
"repositoryId":"120099",
"shippingAddress":{
"lastName":"Butt",
"firstName":"James",
"country":"United States",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"504-845-1427",
"address2":"",
"city":"New Orleans",
"address1":"6649 N Blue Gum St",
"postalCode":"70116",
"county":"Orleans",
"repositoryId":"140010",
"state":"Los Angeles"
},
"id":"120099",
"email":"jbutt@example.com",
"daytimeTelephoneNumber":"",
"shippingAddresses":[
{
"lastName":"Anderson",
"country":"United States",
"address3":"",
"address2":"",
"city":"Syracuse",
"prefix":"",
"address1":"21 Cedar Ave",
"postalCode":"13202",
"jobTitle":"",
"companyName":"",
"county":"",
"isDefaultAddress":false,
"suffix":"",
"selectedCountry":"US",
"firstName":"Kim",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"212-555-1977",
"faxNumber":"",
"middleName":"",
"state":"New York",
"selectedState":"NY",
"state_ISOCode":"US-NY"
},
{
"lastName":"Butt",
"country":"United States",
"address3":"",
"address2":"",
"city":"New Orleans",
"prefix":"",
"address1":"6649 N Blue Gum St",
"postalCode":"70116",
"jobTitle":"",
"companyName":"",
"county":"Orleans",
"isDefaultAddress":true,
"suffix":"",
"selectedCountry":"US",
"firstName":"James",
"externalAddressId":"EXT_ADDR_1",
"phoneNumber":"504-845-1427",
"faxNumber":"",
"middleName":"",
"state":"Los Angeles",
"selectedState":"LA",
"state_ISOCode":"US-LA"
}
]
},
"profileComments":[
{
"repositoryId":"100002",
"comment":"Item not received.",
"creationDate":"2014-06-25 01:50:28.0"
},
{
"repositoryId":"100001",
"comment":"Issue with shipping address.",
"creationDate":"2014-06-25 01:50:20.0"
}
],
"hasIncompleteOrder":false
}
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:
|Error Code|Description|
|------------------|------------------|
|100094|Organization passed in the header is currently inactive|
|100098|Current operation is being performed in an organization context and the shopper profile is not associated to any organization|
|22000|Profile Id passed is null or empty.|
|22001|Internal error occurred while processing the request.|
|100101|The shopper profile does not belong to organization passed in the header|
|200006|Profile comment retrieval failed.|
|22002|No profile found with profile id|
|100102|Organization passed in the header is invalid or does not exist|
|200016|Internal error occurred while processing the profile orders request.|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
errors:
array errors
An optional list of errors if multiple errors were encountered
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code
-
type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code