Get all custom profile specifications
get
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification
Returns a list of custom profile specifications that match the search criteria.
Request
Query Parameters
-
description: string
The description of the resource.
-
eligibleForProject: string
The 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 ID of the resource item.
-
lastUpdate: string
Filters resources by their last update date and time.
-
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.
-
project.id: string
The ID of the project for filtering resource results.
-
project.version: string
The project version for filtering entities.
-
validFor.endDateTime: string
The valid for end date time for filtering entities.
-
validFor.startDateTime: string
The valid for start date time for filtering entities.
-
whereUsed: string
Whether to enrich objects with usedBy information.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The list of custom profile specifications was returned successfully.
Root Schema : schema
Type:
Show Source
array-
Array of:
object CustomProfileSpecificationOracle
Title:
CustomProfileSpecificationOracleThe custom profile specification resource.
Nested Schema : CustomProfileSpecificationOracle
Type:
objectTitle:
CustomProfileSpecificationOracleThe custom profile specification resource.
Show Source
-
@baseType: string
The base type of the custom profile specification.
-
@schemaLocation: string
The URI of the schema that defines the custom profile specification.
-
@type(required): string
The class type of the custom profile specification.
-
applicationName: string
The name of the application associated with the custom profile specification.
-
charValueObject: array
charValueObject
A list of char value objects associated with the custom profile specification.
-
created: string
(date-time)
The date and time of creation.
-
createdBy: string
The name of the person who created.
-
customProfileSpecChar: array
customProfileSpecChar
A list of custom profile specification characteristics associated with the custom profile specification.
-
customProfileSpecRel: array
customProfileSpecRel
A list of custom profile specification rels associated with the custom profile specification.
-
description: string
A string. A narrative that explains in detail what the Custom ProfileSpec is.
-
externalId: string
The ID of the external associated with the custom profile specification.
-
href: string
A string. Reference of the Custom ProfileSpec.
-
id: string
Maximum Length:
30The ID of the custom profile specification. -
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the Custom ProfileSpec.
-
lastUpdatedBy: string
The name of the person who updated.
-
lifecycleStatus: string
Indicates the current lifecycle status of the custom profile specification.
-
name(required): string
A string. Name of the Custom ProfileSpec.
-
profileCode: string
The profile code associated with the custom profile specification.
-
profileType(required): string
Allowed Values:
[ "DEVICE_SPEC", "BUSINESS_CONFIG", "TRADE_IN", "CHARGING_TERM", "SUSPENSION_TERM", "RETURN_CHECKLIST", "ENTITY_PROFILE", "RENEWAL_TERM", "FINANCE_PLAN", "ZONE_VALUE_MAP", "STANDARD_ZONE", "CUSTOM_ANALYZER_RULE", "POLICY_SPEC_TERM", "TIME_MODEL" ]The type or classification of the custom profile specification. -
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. - relatedParty: array relatedParty
-
targetProductSchema: object
TargetProductSchemaOracle
Title:
TargetProductSchemaOracle -
validFor: object
TimePeriod
Title:
TimePeriodThe period for which the productOffering is valid. -
version: string
A string. Custom ProfileSpec version.
-
versionState: number
The version state of the Customer Profile Specification.
Nested Schema : charValueObject
Type:
arrayA list of char value objects associated with the custom profile specification.
Show Source
-
Array of:
object CharValueObjectRefOracle
Title:
CharValueObjectRefOracleThe Reference of the resource referred in CharValue of custom profile specification.
Nested Schema : customProfileSpecChar
Type:
arrayA list of custom profile specification characteristics associated with the custom profile specification.
Show Source
Nested Schema : customProfileSpecRel
Type:
arrayA list of custom profile specification rels associated with the custom profile specification.
Show Source
-
Array of:
object CustomProfileSpecRel
Title:
CustomProfileSpecRelA migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : TargetProductSchemaOracle
Type:
objectTitle:
TargetProductSchemaOracleMatch All
Show Source
-
object
TargetProductSchema
Title:
TargetProductSchemaThe reference object to the schema and type of target product which is described by product specification. -
object
TargetProductSchemaOracle-allOf[1]
Nested Schema : TimePeriod
Type:
objectTitle:
TimePeriodThe period for which the productOffering is valid.
Show Source
-
endDateTime: string
(date-time)
The end date and time of the time period.
-
startDateTime: string
(date-time)
The start date and time of the time period.
Nested Schema : CharValueObjectRefOracle
Type:
objectTitle:
CharValueObjectRefOracleThe Reference of the resource referred in CharValue of custom profile specification.
Show Source
-
@baseType: string
The base type of the characteristic value object reference.
-
@referredType(required): string
The type of the referred characteristic value object reference.
-
@schemaLocation: string
(uri)
The URI of the schema that defines the characteristic value object reference.
-
@type(required): string
The class type of the characteristic value object reference.
-
href: string
The hyperlink reference to the characteristic value object reference.
-
id(required): string
The ID of the characteristic value object reference.
-
name: string
The name of the characteristic value object reference.
-
resourceType: string
Allowed Values:
[ "SERVICE_SPEC" ]The type or classification of the characteristic value object reference. Valid values are SERVICE_SPEC.
Nested Schema : CustomProfileSpecRel
Type:
objectTitle:
CustomProfileSpecRelA migration, substitution, dependency or exclusivity relationship between/among custom profile specifications.
Show Source
-
href: string
The hyperlink reference to the custom profile specification rel.
-
id(required): string
The ID of the custom profile specification rel.
-
relationshipType(required): string
Allowed Values:
[ "AGGREGATION", "MIGRATION", "SUBSTITUTION", "DEPENDENCY", "EXCLUSIVITY", "PARENT", "CONDITION", "EXCLUDES", "REQUIRES", "ALLOWED" ]The type or classification of the custom profile specification rel. Valid values are AGGREGATION, MIGRATION, SUBSTITUTION, DEPENDENCY, EXCLUSIVITY, PARENT, CONDITION, EXCLUDES, REQUIRES, and ALLOWED. -
validFor: object
TimePeriodOracle
Title:
TimePeriodOracleThe validity period of the related party. -
versionState: number
The version state of the reference.
Nested Schema : TimePeriodOracle
Type:
objectTitle:
TimePeriodOracleThe validity period of the related party.
Show Source
-
endDateTime: string
(date-time)
The end date and time of the time period.
-
startDateTime: string
(date-time)
The start date and time of the time period.
Nested Schema : RelatedParty
Type:
objectTitle:
RelatedPartyThe relatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
-
@baseType: string
The base type of the related party reference or party role reference.
-
@schemaLocation: string
A URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The class type of the related party reference or party role reference.
-
partyOrPartyRole(required):
partyOrPartyRole
A list of party or party roles associated with the related party reference or party role reference.
-
role: string
The role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'.
Nested Schema : partyOrPartyRole
Type:
arrayA list of party or party roles associated with the related party reference or party role reference.
Show Source
Nested Schema : TargetProductSchema
Type:
objectTitle:
TargetProductSchemaThe reference object to the schema and type of target product which is described by product specification.
Show Source
-
@schemaLocation(required): string
The URI of the schema that defines the target product schema.
-
@type(required): string
The class type of the target product schema.
Nested Schema : TargetProductSchemaOracle-allOf[1]
Type:
Show Source
object-
subType: string
The type or classification of the target product schema.
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:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
404 Response
The resource with the specified URI couldn't be found.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@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
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
Examples
The following example shows how to get all custom profile specifications by submitting a GET request on the REST resource using cURL.
curl -u username:password -X GET \
'https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/'Example of Response Body
The following example shows the contents of the response body in JSON format.
[
{
"id": "CPS_Suspension_13_1_2025_14_56",
"name": "CPS_Suspension_13_1_2025_14_56_36",
"description": "Promotion Profile Spec in Active state.",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/CPS_Suspension_13_1_2025_14_56",
"version": "1.0",
"lifecycleStatus": "In design",
"created": "2025-01-13T09:29:55.000Z",
"createdBy": "booth",
"lastUpdate": "2025-01-27T07:54:48.162Z",
"lastUpdatedBy": "booth",
"@type": "CustomProfileSpecificationOracle",
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"project": {
"id": "I_13_1_2025_14_56_36",
"name": "I_13_1_2025_14_56_36",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/I_13_1_2025_14_56_36",
"version": "1.0",
"@referredType": "ProjectOracle"
},
"versionState": 0,
"profileType": "SUSPENSION_TERM",
"customProfileSpecChar": [
{
"name": "DeviceType",
"description": "Type of device.",
"valueType": "STRING",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"active": true,
"customProfileSpecCharValue": [
{
"value": "Tablet",
"valueType": "STRING",
"isDefault": false,
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Mobile",
"valueType": "STRING",
"isDefault": false,
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"@type": "CustomProfileSpecCharValue"
}
]
},
{
"name": "Family",
"description": "Family of device.",
"valueType": "STRING",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"active": true,
"customProfileSpecCharValue": [
{
"value": "Note",
"valueType": "STRING",
"isDefault": false,
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Galaxy",
"valueType": "STRING",
"isDefault": false,
"validFor": {
"startDateTime": "2025-01-13T00:00:00.000Z"
},
"@type": "CustomProfileSpecCharValue"
}
]
}
]
},
{
"id": "ATC_SUSPENSION_TERM_TEMP",
"name": "PSP Suspension Term template",
"description": "Suspension Term Template 1",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/customProfileSpecification/ATC_SUSPENSION_TERM_TEMP",
"version": "1.0",
"lifecycleStatus": "In design",
"created": "2025-02-19T11:46:55.000Z",
"createdBy": "booth",
"lastUpdate": "2025-03-10T09:36:45.220Z",
"lastUpdatedBy": "booth",
"@type": "CustomProfileSpecificationOracle",
"validFor": {
"startDateTime": "2024-08-09T00:00:00.000Z",
"endDateTime": "2028-08-09T00:00:00.000Z"
},
"isLocked": false,
"versionState": 0,
"profileType": "SUSPENSION_TERM",
"customProfileSpecChar": [
{
"name": "Contract Duration",
"description": "The impact to contract duration due to suspension",
"valueType": "STRING",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true,
"customProfileSpecCharValue": [
{
"value": "Original Duration",
"valueType": "STRING",
"isDefault": true,
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Extended Duration",
"valueType": "STRING",
"isDefault": false,
"@type": "CustomProfileSpecCharValue"
}
]
},
{
"name": "Duration",
"description": "Duration of suspension",
"valueType": "NUMBER",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true,
"allowedUnits": [
"DAYS",
"MONTHS"
]
},
{
"name": "Duration Of Suspension",
"description": "Define the suspension duration",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true,
"customProfileSpecCharRel": [
{
"id": "ATC_SUSPENSION_TERM_TEMP",
"name": "Duration",
"relationshipType": "AGGREGATION",
"@type": "CustomProfileSpecCharRel",
"charSpecSeq": 1
},
{
"id": "ATC_SUSPENSION_TERM_TEMP",
"name": "Contract Duration",
"relationshipType": "AGGREGATION",
"@type": "CustomProfileSpecCharRel",
"charSpecSeq": 2
},
{
"id": "ATC_SUSPENSION_TERM_TEMP",
"name": "Upgrade Eligibility Duration",
"relationshipType": "AGGREGATION",
"@type": "CustomProfileSpecCharRel",
"charSpecSeq": 3
}
]
},
{
"name": "Maximum Number Of Bill Suspensions",
"description": "Number of Bill suspensions allowed",
"valueType": "NUMBER",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true
},
{
"name": "Suspend Resume Terms",
"description": "Terms to resume suspension",
"valueType": "STRING",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true,
"customProfileSpecCharValue": [
{
"value": "No Suspense",
"valueType": "STRING",
"isDefault": false,
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Suspense At Reduced Rate",
"valueType": "STRING",
"isDefault": false,
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Suspense At Regular Rate",
"valueType": "STRING",
"isDefault": true,
"@type": "CustomProfileSpecCharValue"
}
]
},
{
"name": "Upgrade Eligibility Duration",
"description": "The impact to upgrade eligibility duration due to suspension",
"valueType": "STRING",
"@type": "CustomProfileSpecChar",
"configurable": true,
"minCardinality": 0,
"maxCardinality": 1,
"active": true,
"customProfileSpecCharValue": [
{
"value": "Original Contract Duration",
"valueType": "STRING",
"isDefault": true,
"@type": "CustomProfileSpecCharValue"
},
{
"value": "Extended Duration",
"valueType": "STRING",
"isDefault": false,
"@type": "CustomProfileSpecCharValue"
}
]
}
]
}
]