Get all customer profile specifications
get
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customerProfileSpecification
Request
Query Parameters
-
description: string
The description of the resource.
-
eligibleForProject: string
Project Id
-
fields: string
The comma-separated field names that are returned in the response. The field names are the names that you specify when you create or retrieve a resource.
-
id: string
The unique identifier of the resource item.
-
lifecycleStatus: string
The current lifecycle status of the resource.
-
limit: integer
The number of resources to be returned in the response. The minimum value that can be specified is 1, and the maximum value that can be specified is 100,000. If the specified value is greater than 100,000, then it defaults to 100,000.
-
name: string
The name of the resource.
-
offset: string
The record number from which the retrieval starts. The default value is zero. If no value is specified, then it defaults to zero. The value zero indicates that the retrieval will start from the beginning of the collection.
-
profileType: string
Type of the profile
-
version: string
The current version of the resource.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
OK
Root Schema : schema
Type:
Show Source
array
-
Array of:
object CustomerProfileSpecificationOracle
Title:
CustomerProfileSpecificationOracle
The Customer Profile Specification resource represents a set of customer profile characteristics and relationships.
Nested Schema : CustomerProfileSpecificationOracle
Type:
object
Title:
CustomerProfileSpecificationOracle
The Customer Profile Specification resource represents a set of customer profile characteristics and relationships.
Show Source
-
@baseType: string
Immediate base (class) type of the Customer Profile Specification
-
@schemaLocation: string
A link to the schema describing this Customer Profle Specification
-
@type: string
Class type of the Customer Profile Specification
-
applicationName: string
name of the external application
-
created: string
(date-time)
Date and time of the creation
-
createdBy: string
name of the person who created item
-
custProfSpecCharacteristic: array
custProfSpecCharacteristic
-
custProfSpecificationRelationship: array
custProfSpecificationRelationship
-
description: string
A string. A narrative that explains in detail what the customer profile specification is.
-
externalId: string
id of the external application
-
href: string
A string. Reference of the customer profile specification.
-
id: string
Maximum Length:
30
A string. Unique identifier of the customer profile specification. -
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the Customer Profile specification.
-
lastUpdatedBy: string
name of the person who updated item
-
lifecycleStatus: string
A string. Used to indicate the current lifecycle status of the customer profile specification.
-
name(required): string
A string. Name of the customer profile specification.
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference - relatedParty: array relatedParty
-
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
A string. customer profile specification version.
-
versionState: number
Version state of the Customer Profile Specification
Nested Schema : custProfSpecCharacteristic
Type:
Show Source
array
-
Array of:
object CustProfSpecCharacteristicOracle
Title:
CustProfSpecCharacteristicOracle
A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Nested Schema : custProfSpecificationRelationship
Type:
Show Source
array
-
Array of:
object CustProfSpecRelationshipOracle
Title:
CustProfSpecRelationshipOracle
A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
Nested Schema : TimePeriod
Type:
object
Title:
TimePeriod
The period for which the productOffering is valid
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime(required): string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : CustProfSpecCharacteristicOracle
Type:
object
Title:
CustProfSpecCharacteristicOracle
A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Show Source
-
@baseType: string
base class type (immediate parent) of the CustProfSpecCharacteristic
-
@schemaLocation: string
hyperlink reference to the schema describing this characteristic
-
@type: string
the class type of this characteristic
-
@valueSchemaLocation: string
A string. This (optional) field provides a link to the schema describing the value type.
-
configurable: boolean
A boolean. If true, the Boolean indicates that the CustProfSpecCharacteristic is configurable.
-
custProfSpecCharacteristicValue: array
custProfSpecCharacteristicValue
-
custProfSpecCharRelationship: array
custProfSpecCharRelationship
-
description: string
A string. A narrative that explains in detail what the SpecCharacteristic is.
-
extensible: boolean
A boolean. An indicator that specifies that the values for the characteristic can be extended by adding new values when instantiating a characteristic for an Entity.
-
isUnique: boolean
A boolean. An indicator that specifies if a value is unique for the specification. Possible values are; 'unique while value is in effect' and 'unique whether value is in effect or not'.
-
maxCardinality: integer
An integer. The maximum number of instances a CharacteristicValue can take on.
-
minCardinality: integer
An integer. The minimum number of instances a CharacteristicValue can take on.
-
name(required): string
A string. A word, term, or phrase by which this characteristic specification is known and distinguished from other characteristic specifications.
-
regex: string
A string. A rule or principle represented in regular expression used to derive the value of a characteristic value.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
valueType: string
Allowed Values:
[ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME" ]
A string. A kind of value that the characteristic can take on, such as numeric, text and so forth.
Nested Schema : custProfSpecCharacteristicValue
Type:
Show Source
array
-
Array of:
object CustProfSpecCharacteristicValueOracle
Title:
CustProfSpecCharacteristicValueOracle
A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Nested Schema : custProfSpecCharRelationship
Type:
Show Source
array
-
Array of:
object CustProfSpecCharRelationshipOracle
Title:
CustProfSpecCharRelationshipOracle
A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Nested Schema : TimePeriodOracle
Type:
object
Title:
TimePeriodOracle
Validity period of the related party
Show Source
-
endDateTime: string
(date-time)
An instant of time, ending at the TimePeriod.
-
startDateTime: string
(date-time)
An instant of time, starting at the TimePeriod
Nested Schema : CustProfSpecCharacteristicValueOracle
Type:
object
Title:
CustProfSpecCharacteristicValueOracle
A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Show Source
-
@baseType: string
base class type (immediate parent) of the ServiceSpecCharacteristicValue
-
@schemaLocation: string
Hyperlink reference to schema describing this object
-
@type: string
The class type of the characteristic value
-
isDefault: boolean
A boolean. Indicates if the value is the default value for a characteristic.
-
rangeInterval: string
Allowed Values:
[ "OPEN", "CLOSED", "CLOSED_BOTTOM", "CLOSED_TOP" ]
A string. An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are 'open', 'closed', 'closedBottom' and 'closedTop'. -
regex: string
A string. A regular expression constraint for given value.
-
unitOfMeasure: string
A string. A length, surface, volume, dry measure, liquid measure, money, weight, time, and the like. In general, a determinate quantity or magnitude of the kind designated, taken as a standard of comparison for others of the same kind, in assigning to them numerical values, as 1 foot, 1 yard, 1 mile, 1 square foot.
-
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party -
value(required):
value
An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
-
valueFrom: string
An integer. The low range value that a characteristic can take on.
-
valueTo: string
An integer. The upper range value that a characteristic can take on.
-
valueType: string
Allowed Values:
[ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME" ]
A string. A kind of value that the characteristic can take on, such as numeric, text, and so forth.
Nested Schema : value
An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
Match One Schema
Show Source
Nested Schema : value-oneOf[1]
Type:
object
Nested Schema : value-oneOf[4]
Type:
array
Nested Schema : CustProfSpecCharRelationshipOracle
Type:
object
Title:
CustProfSpecCharRelationshipOracle
A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Show Source
-
@baseType: string
base class type (immediate parent) of the CustomerProfileSpecCharacteristicRelationship
-
@schemaLocation: string
hyperlink reference to schema describing this object
-
@type: string
Class type of target customer profile specification Characteristic Relationship
-
charSpecSeq: integer
Characteristic sequence.
-
href: string
A string. Reference of the target customer profile.
-
id(required): string
A string. Unique identifier of the target customer profile Specification.
-
name(required): string
A string. Name of the target characteristic.
-
relationshipType(required): string
Allowed Values:
[ "AGGREGATION", "MIGRATION", "SUBSTITUTION", "DEPENDENCY", "EXCLUSIVITY" ]
A string. Type of relationship such as aggregation, migration, substitution, dependency, exclusivity. -
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party
Nested Schema : CustProfSpecRelationshipOracle
Type:
object
Title:
CustProfSpecRelationshipOracle
A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Show Source
-
@baseType: string
The immediate base class type of the specification
-
@schemaLocation: string
A link to the schema describing this specification entity
-
@type: string
the class type of the specification
-
href: string
Reference of the specification
-
id(required): string
Unique identifier of the specification
-
name: string
name of the specification
-
relationshipType(required): string
Allowed Values:
[ "AGGREGATION", "MIGRATION", "SUBSTITUTION", "DEPENDENCY", "EXCLUSIVITY" ]
A string. Type of relationship such as migration, substitution, dependency, exclusivity. -
validFor: object
TimePeriodOracle
Title:
TimePeriodOracle
Validity period of the related party
Nested Schema : RelatedParty
Type:
object
Title:
RelatedParty
RelatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
-
@baseType: string
The immediate base class type of the RelatedParty
-
@referredType: string
The class type of referred party/party role reference
-
@schemaLocation: string
A link to the schema describing this RelatedParty entity
-
@type: string
the class type of the RelatedParty
-
href: string
Reference of the related party, could be a party reference or a party role reference
-
id(required): string
Unique identifier of a related party
-
name: string
Name of the related party
-
role: string
Role of the related party.
400 Response
Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
404 Response
Your request includes a resource URI that doesn't exist.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
Examples
The following example shows how to get all customer profile specifications by submitting a GET request on the REST resource using cURL.
cURL Command
curl -u username:password -X GET https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customerProfileSpecification
Example of Response Body
The following shows the contents of the response body in JSON format.
[ { "id": "CP3001005418450", "name": "profile to setup color", "description": "updated description", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customerProfileSpecification/CP3001005418450", "version": "1.0", "lifecycleStatus": "In design", "created": "2021-04-01T12:17:48.000Z", "createdBy": "booth", "lastUpdate": "2021-04-01T12:28:26.000Z", "lastUpdatedBy": "booth", "@type": "CustomerProfileSpecificationOracle", "@baseType": "CustomerProfileSpecificationOracle", "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "project": { "id": "MyProject3000", "name": "MyProject3000" }, "custProfSpecCharacteristic": [ { "name": "customerType", "description": "customerType", "valueType": "STRING", "extensible": true, "configurable": true, "isUnique": true, "minCardinality": 0, "maxCardinality": 1, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "custProfSpecCharacteristicValue": [ { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Gold" }, { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Silver" } ] } ], "custProfSpecificationRelationship": [ { "id": "Oracle_IVPVJCH3", "relationshipType": "AGGREGATION", "validFor": { "startDateTime": "2020-08-28T23:47:27.000Z", "endDateTime": "2020-08-28T23:47:27.000Z" }, "name": "Names_ZTX4ZSI0W" } ] }, { "id": "CP3001005418237", "name": "profile to setup color 235", "description": "updated description", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customerProfileSpecification/CP3001005418237", "version": "1.0", "lifecycleStatus": "In design", "created": "2021-04-01T07:55:40.000Z", "createdBy": "booth", "lastUpdate": "2021-04-01T07:55:40.000Z", "lastUpdatedBy": "booth", "@type": "CustomerProfileSpecificationOracle", "@baseType": "CustomerProfileSpecificationOracle", "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "project": { "id": "MyProject3000", "name": "MyProject3000" }, "custProfSpecCharacteristic": [ { "name": "customerType", "description": "customerType", "valueType": "STRING", "extensible": true, "configurable": true, "isUnique": true, "minCardinality": 0, "maxCardinality": 1, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "custProfSpecCharacteristicValue": [ { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Gold" }, { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Silver" } ] } ], "custProfSpecificationRelationship": [ { "id": "CP3001005418236", "relationshipType": "AGGREGATION", "validFor": { "startDateTime": "2020-08-28T23:47:27.000Z", "endDateTime": "2020-08-28T23:47:27.000Z" }, "name": "profile to setup color" } ] }, { "id": "CP3001005418236", "name": "profile to setup color", "description": "updated description", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customerProfileSpecification/CP3001005418236", "version": "1.0", "lifecycleStatus": "In design", "created": "2021-04-01T07:40:53.000Z", "createdBy": "booth", "lastUpdate": "2021-04-01T07:44:51.000Z", "lastUpdatedBy": "booth", "@type": "CustomerProfileSpecificationOracle", "@baseType": "CustomerProfileSpecificationOracle", "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "project": { "id": "MyProject3000", "name": "MyProject3000" }, "custProfSpecCharacteristic": [ { "name": "customerType", "description": "customerType", "valueType": "STRING", "extensible": true, "configurable": true, "isUnique": true, "minCardinality": 0, "maxCardinality": 1, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "custProfSpecCharacteristicValue": [ { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Gold" }, { "isDefault": false, "validFor": { "startDateTime": "2020-01-18T00:00:00.000Z", "endDateTime": "2021-02-20T16:42:23.000Z" }, "valueType": "STRING", "value": "Silver" } ] } ] } ]