REST API Reference for Launch Cloud Service

Get a product specification

get

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v5/productSpecification/{id}

Returns the product specification that matches the specified ID, including its configured details.

Request

Path Parameters

id(required): string

The ID of the resource item.

Query Parameters

eligibleVersionForProject: 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.

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

The product specification was returned successfully.

Root Schema : ProductSpecificationOracle

Title: ProductSpecificationOracle

Match All

Show Source

object ProductSpecification

Title: ProductSpecification

Discriminator: { "propertyName":"@type", "mapping":{ "ProductSpecification":"#/components/schemas/ProductSpecification", "ProductSpecificationOracle":"#/components/schemas/ProductSpecificationOracle" } }

The product specification resource.
object type

{
    "title":"ProductSpecificationOracle",
    "allOf":[
        {
            "$ref":"#/components/schemas/ProductSpecification"
        },
        {
            "type":"object",
            "properties":{
                "category":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/CategoryRef"
                    },
                    "description":"A list of categories associated with the product specification."
                },
                "project":{
                    "$ref":"#/components/schemas/ProjectRef",
                    "description":"The project associated with the product specification."
                },
                "created":{
                    "type":"string",
                    "format":"date-time",
                    "description":"The date and time of the creation."
                },
                "createdBy":{
                    "type":"string",
                    "description":"The name of the person who created item."
                },
                "lastUpdatedBy":{
                    "type":"string",
                    "description":"The name of the person who updated item."
                },
                "usageSpecification":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/UsageSpecificationRefOracle"
                    },
                    "description":"A list of usage specifications associated with the product specification."
                },
                "customerProfileSpecification":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/CustomerProfileSpecificationRef"
                    },
                    "description":"A list of customer profile specifications associated with the product specification."
                },
                "usedBy":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/UsedByRef"
                    },
                    "description":"A list of used bies associated with the product specification."
                },
                "customProfileSpec":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/CustomProfileSpecRefOracle"
                    },
                    "description":"A list of custom profile specifications associated with the product specification."
                },
                "externalId":{
                    "type":"string",
                    "description":"The ID of the external associated with the product specification."
                },
                "applicationName":{
                    "type":"string",
                    "description":"The name of the application associated with the product specification."
                },
                "versionState":{
                    "type":"number",
                    "description":"The version state of the Product Specification."
                }
            }
        }
    ]
}

Nested Schema : ProductSpecification

Type: object

Title: ProductSpecification

Discriminator: @type

{
    "title":"ProductSpecification",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "maxLength":30,
            "description":"The ID of the product specification."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the product specification."
        },
        "name":{
            "type":"string",
            "description":"The name of the product specification."
        },
        "description":{
            "type":"string",
            "description":"A narrative that explains in detail what the product specification is."
        },
        "brand":{
            "type":"string",
            "description":"The manufacturer or trademark of the specification."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Determines whether a product specification represents a single product specification (false) or a bundle of product specifications (true)."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"The date and time when the product specification was last updated."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"The status of the product specification."
        },
        "productNumber":{
            "type":"string",
            "description":"The product number associated with the product specification."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product specification is valid."
        },
        "version":{
            "type":"string",
            "description":"The product specification version."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the product specification."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the product specification."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the product specification."
        },
        "relatedParty":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/RelatedPartyRefOrPartyRoleRef"
            },
            "description":"A list of related parties associated with the product specification."
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "anyOf":[
                    {
                        "$ref":"#/components/schemas/CharacteristicSpecificationOracle"
                    },
                    {
                        "$ref":"#/components/schemas/AttributeRefOracle"
                    }
                ]
            },
            "description":"A list of product specification characteristics associated with the product specification."
        },
        "serviceSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ServiceSpecificationRefOracle"
            },
            "description":"A list of service specifications associated with the product specification."
        },
        "targetProductSchema":{
            "$ref":"#/components/schemas/TargetProductSchema",
            "description":"The target product schema for the product specification."
        },
        "productSpecificationRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationRelationship"
            },
            "description":"A list of product specification relationships associated with the product specification."
        },
        "resourceSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ResourceSpecificationRef"
            },
            "description":"A list of resource specifications associated with the product specification."
        },
        "attachment":{
            "type":"array",
            "items":{
                "anyOf":[
                    {
                        "$ref":"#/components/schemas/Attachment"
                    },
                    {
                        "$ref":"#/components/schemas/AttachmentOracle"
                    },
                    {
                        "$ref":"#/components/schemas/AttachmentRef"
                    }
                ],
                "discriminator":{
                    "propertyName":"@type",
                    "mapping":{
                        "Attachment":"#/components/schemas/Attachment",
                        "AttachmentOracle":"#/components/schemas/AttachmentOracle",
                        "AttachmentRef":"#/components/schemas/AttachmentRef"
                    }
                }
            },
            "description":"A list of attachments associated with the product specification."
        },
        "bundledProductSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductSpecification"
            },
            "description":"A list of bundled product specifications associated with the product specification."
        }
    },
    "required":[
        "name",
        "@type"
    ],
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductSpecification":"#/components/schemas/ProductSpecification",
            "ProductSpecificationOracle":"#/components/schemas/ProductSpecificationOracle"
        }
    },
    "description":"The product specification resource."
}

The product specification resource.

Show Source

@baseType: string

The base type of the product specification.
@schemaLocation: string

The URI of the schema that defines the product specification.
@type(required): string

The class type of the product specification.
attachment: array attachment

A list of attachments associated with the product specification.
brand: string

The manufacturer or trademark of the specification.
bundledProductSpecification: array bundledProductSpecification

A list of bundled product specifications associated with the product specification.
description: string

A narrative that explains in detail what the product specification is.
href: string

The hyperlink reference to the product specification.
id: string

Maximum Length: 30

The ID of the product specification.
isBundle: boolean

Determines whether a product specification represents a single product specification (false) or a bundle of product specifications (true).
lastUpdate: string (date-time)

The date and time when the product specification was last updated.
lifecycleStatus: string

The status of the product specification.
name(required): string

The name of the product specification.
productNumber: string

The product number associated with the product specification.
productSpecCharacteristic: array productSpecCharacteristic

A list of product specification characteristics associated with the product specification.
productSpecificationRelationship: array productSpecificationRelationship

A list of product specification relationships associated with the product specification.
relatedParty: array relatedParty

A list of related parties associated with the product specification.
resourceSpecification: array resourceSpecification

A list of resource specifications associated with the product specification.
serviceSpecification: array serviceSpecification

A list of service specifications associated with the product specification.
targetProductSchema: object TargetProductSchema

Title: TargetProductSchema

The reference object to the schema and type of target product which is described by product specification.
validFor: object TimePeriod

Title: TimePeriod

The period for which the productOffering is valid.
version: string

The product specification version.

{
    "title":"ProductSpecification",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "maxLength":30,
            "description":"The ID of the product specification."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the product specification."
        },
        "name":{
            "type":"string",
            "description":"The name of the product specification."
        },
        "description":{
            "type":"string",
            "description":"A narrative that explains in detail what the product specification is."
        },
        "brand":{
            "type":"string",
            "description":"The manufacturer or trademark of the specification."
        },
        "isBundle":{
            "type":"boolean",
            "description":"Determines whether a product specification represents a single product specification (false) or a bundle of product specifications (true)."
        },
        "lastUpdate":{
            "type":"string",
            "format":"date-time",
            "description":"The date and time when the product specification was last updated."
        },
        "lifecycleStatus":{
            "type":"string",
            "description":"The status of the product specification."
        },
        "productNumber":{
            "type":"string",
            "description":"The product number associated with the product specification."
        },
        "validFor":{
            "$ref":"#/components/schemas/TimePeriod",
            "description":"The period for which the product specification is valid."
        },
        "version":{
            "type":"string",
            "description":"The product specification version."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the product specification."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the product specification."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the product specification."
        },
        "relatedParty":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/RelatedPartyRefOrPartyRoleRef"
            },
            "description":"A list of related parties associated with the product specification."
        },
        "productSpecCharacteristic":{
            "type":"array",
            "items":{
                "anyOf":[
                    {
                        "$ref":"#/components/schemas/CharacteristicSpecificationOracle"
                    },
                    {
                        "$ref":"#/components/schemas/AttributeRefOracle"
                    }
                ]
            },
            "description":"A list of product specification characteristics associated with the product specification."
        },
        "serviceSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ServiceSpecificationRefOracle"
            },
            "description":"A list of service specifications associated with the product specification."
        },
        "targetProductSchema":{
            "$ref":"#/components/schemas/TargetProductSchema",
            "description":"The target product schema for the product specification."
        },
        "productSpecificationRelationship":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProductSpecificationRelationship"
            },
            "description":"A list of product specification relationships associated with the product specification."
        },
        "resourceSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ResourceSpecificationRef"
            },
            "description":"A list of resource specifications associated with the product specification."
        },
        "attachment":{
            "type":"array",
            "items":{
                "anyOf":[
                    {
                        "$ref":"#/components/schemas/Attachment"
                    },
                    {
                        "$ref":"#/components/schemas/AttachmentOracle"
                    },
                    {
                        "$ref":"#/components/schemas/AttachmentRef"
                    }
                ],
                "discriminator":{
                    "propertyName":"@type",
                    "mapping":{
                        "Attachment":"#/components/schemas/Attachment",
                        "AttachmentOracle":"#/components/schemas/AttachmentOracle",
                        "AttachmentRef":"#/components/schemas/AttachmentRef"
                    }
                }
            },
            "description":"A list of attachments associated with the product specification."
        },
        "bundledProductSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BundledProductSpecification"
            },
            "description":"A list of bundled product specifications associated with the product specification."
        }
    },
    "required":[
        "name",
        "@type"
    ],
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "ProductSpecification":"#/components/schemas/ProductSpecification",
            "ProductSpecificationOracle":"#/components/schemas/ProductSpecificationOracle"
        }
    },
    "description":"The product specification resource."
}

Nested Schema : type

Type: object

Show Source

applicationName: string

The name of the application associated with the product specification.
category: array category

A list of categories associated with the product specification.
created: string (date-time)

The date and time of the creation.
createdBy: string

The name of the person who created item.
customerProfileSpecification: array customerProfileSpecification

A list of customer profile specifications associated with the product specification.
customProfileSpec: array customProfileSpec

A list of custom profile specifications associated with the product specification.
externalId: string

The ID of the external associated with the product specification.
lastUpdatedBy: string

The name of the person who updated item.
project: object ProjectRef

Title: ProjectRef

The project reference resource.
usageSpecification: array usageSpecification

A list of usage specifications associated with the product specification.
usedBy: array usedBy

A list of used bies associated with the product specification.
versionState: number

The version state of the Product Specification.

{
    "type":"object",
    "properties":{
        "category":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CategoryRef"
            },
            "description":"A list of categories associated with the product specification."
        },
        "project":{
            "$ref":"#/components/schemas/ProjectRef",
            "description":"The project associated with the product specification."
        },
        "created":{
            "type":"string",
            "format":"date-time",
            "description":"The date and time of the creation."
        },
        "createdBy":{
            "type":"string",
            "description":"The name of the person who created item."
        },
        "lastUpdatedBy":{
            "type":"string",
            "description":"The name of the person who updated item."
        },
        "usageSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UsageSpecificationRefOracle"
            },
            "description":"A list of usage specifications associated with the product specification."
        },
        "customerProfileSpecification":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CustomerProfileSpecificationRef"
            },
            "description":"A list of customer profile specifications associated with the product specification."
        },
        "usedBy":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/UsedByRef"
            },
            "description":"A list of used bies associated with the product specification."
        },
        "customProfileSpec":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/CustomProfileSpecRefOracle"
            },
            "description":"A list of custom profile specifications associated with the product specification."
        },
        "externalId":{
            "type":"string",
            "description":"The ID of the external associated with the product specification."
        },
        "applicationName":{
            "type":"string",
            "description":"The name of the application associated with the product specification."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the Product Specification."
        }
    }
}

Nested Schema : category

Type: array

A list of categories associated with the product specification.

Show Source

Array of: object CategoryRef

Title: CategoryRef

The category reference. The category resource groups product offerings, service candidates, and resource candidates in logical containers. Categories can contain other categories and/or product offerings, resource candidates, or service candidates.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/CategoryRef"
    },
    "description":"A list of categories associated with the product specification."
}

Nested Schema : customerProfileSpecification

Type: array

A list of customer profile specifications associated with the product specification.

Show Source

Array of: object CustomerProfileSpecificationRef

Title: CustomerProfileSpecificationRef

The customer Profile specification reference.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/CustomerProfileSpecificationRef"
    },
    "description":"A list of customer profile specifications associated with the product specification."
}

Nested Schema : customProfileSpec

Type: array

A list of custom profile specifications associated with the product specification.

Show Source

Array of: object CustomProfileSpecRefOracle

Title: CustomProfileSpecRefOracle

The custom Profile specification reference.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/CustomProfileSpecRefOracle"
    },
    "description":"A list of custom profile specifications associated with the product specification."
}

Nested Schema : ProjectRef

Type: object

Title: ProjectRef

The 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.

{
    "title":"ProjectRef",
    "type":"object",
    "description":"The project reference resource.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the project reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the project reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the project reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the project."
        }
    },
    "required":[
        "id"
    ]
}

Nested Schema : usageSpecification

Type: array

A list of usage specifications associated with the product specification.

Show Source

Array of: UsageSpecificationRefOracle

Title: UsageSpecificationRefOracle

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UsageSpecificationRefOracle"
    },
    "description":"A list of usage specifications associated with the product specification."
}

Nested Schema : usedBy

Type: array

A list of used bies associated with the product specification.

Show Source

Array of: object UsedByRef

Title: UsedByRef

A reference to a resource that is aggregating another top-level resource.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/UsedByRef"
    },
    "description":"A list of used bies associated with the product specification."
}

Nested Schema : CategoryRef

Type: object

Title: CategoryRef

The category reference. The category resource groups product offerings, service candidates, and resource candidates in logical containers. Categories can contain other categories and/or product offerings, resource candidates, or service candidates.

Show Source

@baseType: string

The base type of the category reference.
@referredType(required): string

The type of the referred category reference.
@schemaLocation: string

The URI of the schema that defines the category reference.
@type(required): string

The class type of the category reference.
href: string

The hyperlink reference to the category reference.
id(required): string

The ID of the category reference.
name: string

The name of the category reference.
version: string

The category version.
versionState: number

The version state of the reference.

{
    "title":"CategoryRef",
    "type":"object",
    "description":"The category reference. The category resource groups product offerings, service candidates, and resource candidates in logical containers. Categories can contain other categories and/or product offerings, resource candidates, or service candidates.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the category reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the category reference."
        },
        "version":{
            "type":"string",
            "description":"The category version."
        },
        "name":{
            "type":"string",
            "description":"The name of the category reference."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the category reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the category reference."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the category reference."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred category reference."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the reference."
        }
    },
    "required":[
        "id",
        "@type",
        "@referredType"
    ]
}

Nested Schema : CustomerProfileSpecificationRef

Type: object

Title: CustomerProfileSpecificationRef

The customer Profile specification reference.

Show Source

@baseType: string

The base type of the customer profile specification reference.
@referredType(required): string

The type of the referred customer profile specification reference.
@schemaLocation: string

The URI of the schema that defines the customer profile specification reference.
@type(required): string

The class type of the customer profile specification reference.
href: string

The hyperlink reference to the customer profile specification reference.
id(required): string

The ID of the customer profile specification reference.
name: string

The name of the customer profile specification reference.
version: string

The version of the usage specification.
versionState: number

The version state of the reference.

{
    "title":"CustomerProfileSpecificationRef",
    "type":"object",
    "description":"The customer Profile specification reference.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the customer profile specification reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the customer profile specification reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the customer profile specification reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the usage specification."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred customer profile specification reference."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the customer profile specification reference."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the customer profile specification reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the customer profile specification reference."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the reference."
        }
    },
    "required":[
        "id",
        "@type",
        "@referredType"
    ]
}

Nested Schema : CustomProfileSpecRefOracle

Type: object

Title: CustomProfileSpecRefOracle

The custom Profile specification reference.

Show Source

@baseType: string

The base type of the custom profile specification reference.
@referredType(required): string

The type of the referred custom profile specification reference.
@schemaLocation: string

The URI of the schema that defines the custom profile specification reference.
@type(required): string

The class type of the custom profile specification reference.
href: string

The hyperlink reference to the custom profile specification reference.
id(required): string

The ID of the custom profile specification reference.
name: string

The name of the custom profile specification reference.
version: string

The version of the custom specification.
versionState: number

The version state of the reference.

{
    "title":"CustomProfileSpecRefOracle",
    "type":"object",
    "description":"The custom Profile specification reference.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the custom profile specification reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the custom profile specification reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the custom profile specification reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the custom specification."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred custom profile specification reference."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the custom profile specification reference."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the custom profile specification reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the custom profile specification reference."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the reference."
        }
    },
    "required":[
        "id",
        "@type",
        "@referredType"
    ]
}

Nested Schema : UsageSpecificationRefOracle

Title: UsageSpecificationRefOracle

Match All

Show Source

object UsageSpecificationRef

Title: UsageSpecificationRef

Discriminator: { "propertyName":"@type", "mapping":{ "UsageSpecificationRef":"#/components/schemas/UsageSpecificationRef", "UsageSpecificationRefOracle":"#/components/schemas/UsageSpecificationRefOracle" } }

The usage specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a ProductOffering to customers or other parties playing a party role.
object UsageSpecificationRefOracle-allOf[1]

{
    "title":"UsageSpecificationRefOracle",
    "allOf":[
        {
            "$ref":"#/components/schemas/UsageSpecificationRef"
        },
        {
            "type":"object",
            "properties":{
                "usageCode":{
                    "type":"string",
                    "description":"The usage code associated with the usage specification reference."
                }
            }
        }
    ]
}

Nested Schema : UsageSpecificationRef

Type: object

Title: UsageSpecificationRef

Discriminator: @type

Discriminator Values

UsageSpecificationRef
UsageSpecificationRefOracle

{
    "title":"UsageSpecificationRef",
    "type":"object",
    "description":"The usage specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a ProductOffering to customers or other parties playing a party role.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the usage specification reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the usage specification reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the usage specification reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the usage specification."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred usage specification reference."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the usage specification reference."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the usage specification reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the usage specification reference."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the reference."
        }
    },
    "required":[
        "id",
        "@type",
        "@referredType"
    ],
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "UsageSpecificationRef":"#/components/schemas/UsageSpecificationRef",
            "UsageSpecificationRefOracle":"#/components/schemas/UsageSpecificationRefOracle"
        }
    }
}

The usage specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a ProductOffering to customers or other parties playing a party role.

Show Source

@baseType: string

The base type of the usage specification reference.
@referredType(required): string

The type of the referred usage specification reference.
@schemaLocation: string

The URI of the schema that defines the usage specification reference.
@type(required): string

The class type of the usage specification reference.
href: string

The hyperlink reference to the usage specification reference.
id(required): string

The ID of the usage specification reference.
name: string

The name of the usage specification reference.
version: string

The version of the usage specification.
versionState: number

The version state of the reference.

{
    "title":"UsageSpecificationRef",
    "type":"object",
    "description":"The usage specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a ProductOffering to customers or other parties playing a party role.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the usage specification reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the usage specification reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the usage specification reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the usage specification."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred usage specification reference."
        },
        "@type":{
            "type":"string",
            "description":"The class type of the usage specification reference."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the usage specification reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the usage specification reference."
        },
        "versionState":{
            "type":"number",
            "description":"The version state of the reference."
        }
    },
    "required":[
        "id",
        "@type",
        "@referredType"
    ],
    "discriminator":{
        "propertyName":"@type",
        "mapping":{
            "UsageSpecificationRef":"#/components/schemas/UsageSpecificationRef",
            "UsageSpecificationRefOracle":"#/components/schemas/UsageSpecificationRefOracle"
        }
    }
}

Nested Schema : UsageSpecificationRefOracle-allOf[1]

Type: object

Show Source

usageCode: string

The usage code associated with the usage specification reference.

{
    "type":"object",
    "properties":{
        "usageCode":{
            "type":"string",
            "description":"The usage code associated with the usage specification reference."
        }
    }
}

Nested Schema : UsedByRef

Type: object

Title: UsedByRef

A reference to a resource that is aggregating another top-level resource.

Show Source

@baseType: string

The base type of the used by reference.
@referredType: string

The type of the referred used by reference.
href: string

The hyperlink reference to the used by reference.
id: string

The ID of the used by reference.
name: string

The name of the used by reference.
referenceType: string

Allowed Values: [ "PACKAGE", "COMMERCIAL_BUNDLE", "SERVICE_BUNDLE", "SERVICE", "DEVICE", "ACCESSORY", "CHOICE", "AGGREGATION", "AWARD", "DISCOUNT", "TRADE_IN", "COMPATIBILITY", "ELIGIBILITY", "MIGRATION", "RECOMMENDATION", "POLICY", "DEVICE_SPEC", "CHARGING_TERM", "SUSPENSION_TERM", "RETURN_CHECKLIST", "ENTITY_PROFILE", "PRODUCT_LINE", "PRODUCT_OFFERING_PRICE", "CATALOG", "CATEGORY", "PRODUCT_SPECIFICATION", "USAGE_SPECIFICATION", "SERVICE_SPECIFICATION" ]

The type or classification of the used by reference.
version: string

The version of the using item.

{
    "title":"UsedByRef",
    "type":"object",
    "description":"A reference to a resource that is aggregating another top-level resource.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID of the used by reference."
        },
        "href":{
            "type":"string",
            "description":"The hyperlink reference to the used by reference."
        },
        "name":{
            "type":"string",
            "description":"The name of the used by reference."
        },
        "version":{
            "type":"string",
            "description":"The version of the using item."
        },
        "@referredType":{
            "type":"string",
            "description":"The type of the referred used by reference."
        },
        "@baseType":{
            "type":"string",
            "description":"The base type of the used by reference."
        },
        "referenceType":{
            "type":"string",
            "description":"The type or classification of the used by reference.",
            "enum":[
                "PACKAGE",
                "COMMERCIAL_BUNDLE",
                "SERVICE_BUNDLE",
                "SERVICE",
                "DEVICE",
                "ACCESSORY",
                "CHOICE",
                "AGGREGATION",
                "AWARD",
                "DISCOUNT",
                "TRADE_IN",
                "COMPATIBILITY",
                "ELIGIBILITY",
                "MIGRATION",
                "RECOMMENDATION",
                "POLICY",
                "DEVICE_SPEC",
                "CHARGING_TERM",
                "SUSPENSION_TERM",
                "RETURN_CHECKLIST",
                "ENTITY_PROFILE",
                "PRODUCT_LINE",
                "PRODUCT_OFFERING_PRICE",
                "CATALOG",
                "CATEGORY",
                "PRODUCT_SPECIFICATION",
                "USAGE_SPECIFICATION",
                "SERVICE_SPECIFICATION"
            ]
        }
    }
}

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: Error

The 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.

{
    "title":"Error",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application related code (as defined in the API or from a common list)."
        },
        "reason":{
            "type":"string",
            "description":"The text that explains the reason for error. This can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"The text that provides more details and corrective actions related to the error. This can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"The status of the error."
        },
        "referenceError":{
            "type":"string",
            "description":"The URL pointing to documentation describing the error."
        },
        "@type":{
            "type":"string",
            "description":"The class type of a REST resource."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the error."
        }
    },
    "required":[
        "code",
        "reason"
    ],
    "description":"The error resource."
}

401 Response

Your request isn't authorized. The authentication credentials included with this request are missing or invalid.

Root Schema : Error

Type: object

Title: Error

The 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.

{
    "title":"Error",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application related code (as defined in the API or from a common list)."
        },
        "reason":{
            "type":"string",
            "description":"The text that explains the reason for error. This can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"The text that provides more details and corrective actions related to the error. This can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"The status of the error."
        },
        "referenceError":{
            "type":"string",
            "description":"The URL pointing to documentation describing the error."
        },
        "@type":{
            "type":"string",
            "description":"The class type of a REST resource."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the error."
        }
    },
    "required":[
        "code",
        "reason"
    ],
    "description":"The error resource."
}

404 Response

The resource with the specified URI couldn't be found.

Root Schema : Error

Type: object

Title: Error

The 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.

{
    "title":"Error",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application related code (as defined in the API or from a common list)."
        },
        "reason":{
            "type":"string",
            "description":"The text that explains the reason for error. This can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"The text that provides more details and corrective actions related to the error. This can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"The status of the error."
        },
        "referenceError":{
            "type":"string",
            "description":"The URL pointing to documentation describing the error."
        },
        "@type":{
            "type":"string",
            "description":"The class type of a REST resource."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the error."
        }
    },
    "required":[
        "code",
        "reason"
    ],
    "description":"The error resource."
}

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: Error

The 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.

{
    "title":"Error",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application related code (as defined in the API or from a common list)."
        },
        "reason":{
            "type":"string",
            "description":"The text that explains the reason for error. This can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"The text that provides more details and corrective actions related to the error. This can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"The status of the error."
        },
        "referenceError":{
            "type":"string",
            "description":"The URL pointing to documentation describing the error."
        },
        "@type":{
            "type":"string",
            "description":"The class type of a REST resource."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the error."
        }
    },
    "required":[
        "code",
        "reason"
    ],
    "description":"The error resource."
}

500 Response

The server encountered something unexpected that prevented it from completing the request.

Root Schema : Error

Type: object

Title: Error

The 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.

{
    "title":"Error",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application related code (as defined in the API or from a common list)."
        },
        "reason":{
            "type":"string",
            "description":"The text that explains the reason for error. This can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"The text that provides more details and corrective actions related to the error. This can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"The status of the error."
        },
        "referenceError":{
            "type":"string",
            "description":"The URL pointing to documentation describing the error."
        },
        "@type":{
            "type":"string",
            "description":"The class type of a REST resource."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The URI of the schema that defines the error."
        }
    },
    "required":[
        "code",
        "reason"
    ],
    "description":"The error resource."
}

Examples

The following example shows how to get a category 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/tmf-api/productCatalogManagement/v5/productSpecification/{id} \ -H 'Content-Type: application/json'

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
    "id": "PS-DataRoaming",
    "name": "Data Roaming PS",
    "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v5/productSpecification/PS-DataRoaming",
    "version": "1.0",
    "lifecycleStatus": "In design",
    "created": "2025-01-20T13:31:42.000Z",
    "createdBy": "booth",
    "lastUpdate": "2025-02-17T11:48:08.292Z",
    "lastUpdatedBy": "booth",
    "isBundle": false,
    "@type": "ProductSpecificationOracle",
    "validFor": {
        "startDateTime": "2024-09-03T00:00:00.000Z"
    },
    "project": {
        "id": "DBE_RI_Mob_ProdModel_PSP",
        "name": "DBE RI Mobile Product Model",
        "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_Mob_ProdModel_PSP",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    },
    "serviceSpecification": [
        {
            "id": "SS-WRLSS-BANDWIDTH",
            "name": "Wireless Data Bandwidth SS",
            "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/SS-WRLSS-BANDWIDTH",
            "version": "1.0",
            "@referredType": "ServiceSpecificationOracle",
            "versionState": -1,
            "@type": "ServiceSpecificationRefOracle",
            "role": "PRIMARY",
            "serviceCode": "/service/telco/gsm/data"
        }
    ],
    "productSpecCharacteristic": [
        {
            "id": "ATT-MAX-SPEED",
            "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v5/productSpecification/PS-DataRoaming/ATT-MAX-SPEED",
            "name": "Max Speed",
            "version": "1.0",
            "lifecycleStatus": "Ready to publish",
            "valueType": "STRING",
            "@type": "AttributeOracle",
            "extensible": true,
            "configurable": true,
            "minCardinality": 0,
            "maxCardinality": 1,
            "validFor": {
                "startDateTime": "2024-09-03T00:00:00.000Z"
            },
            "lastUpdate": "2025-02-17T11:46:03.885Z",
            "lastUpdatedBy": "booth",
            "created": "2025-01-20T13:31:18.383Z",
            "createdBy": "booth",
            "project": {
                "id": "DBE_RI_Mob_ProdModel_PSP",
                "name": "DBE RI Mobile Product Model",
                "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_Mob_ProdModel_PSP",
                "version": "1.0",
                "@referredType": "ProjectOracle"
            },
            "displayName": "Max Speed",
            "fulfillmentUpdatable": true,
            "characteristicValueSpecification": [
                {
                    "value": "3G",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 1
                },
                {
                    "value": "4G",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 2
                },
                {
                    "value": "5G",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": true,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 3
                }
            ]
        },
        {
            "id": "ATT-Quota",
            "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v5/productSpecification/PS-DataRoaming/ATT-Quota",
            "name": "Quota",
            "version": "1.0",
            "lifecycleStatus": "Ready to publish",
            "valueType": "NUMBER",
            "@type": "AttributeOracle",
            "extensible": true,
            "configurable": true,
            "minCardinality": 1,
            "maxCardinality": 1,
            "validFor": {
                "startDateTime": "2024-09-03T00:00:00.000Z"
            },
            "lastUpdate": "2025-02-17T11:46:03.945Z",
            "lastUpdatedBy": "booth",
            "created": "2025-01-20T13:31:18.000Z",
            "createdBy": "booth",
            "project": {
                "id": "DBE_RI_Mob_ProdModel_PSP",
                "name": "DBE RI Mobile Product Model",
                "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_Mob_ProdModel_PSP",
                "version": "1.0",
                "@referredType": "ProjectOracle"
            },
            "displayName": "Quota",
            "characteristicValueSpecification": [
                {
                    "value": 1,
                    "valueType": "NUMBER",
                    "unitOfMeasure": "GIGABYTE",
                    "isDefault": true,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 1
                },
                {
                    "value": 5,
                    "valueType": "NUMBER",
                    "unitOfMeasure": "GIGABYTE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 2
                },
                {
                    "value": 10,
                    "valueType": "NUMBER",
                    "unitOfMeasure": "GIGABYTE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 3
                }
            ]
        },
        {
            "id": "ATT-ROAM-AREA",
            "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v5/productSpecification/PS-DataRoaming/ATT-ROAM-AREA",
            "name": "Roaming Area",
            "version": "1.0",
            "lifecycleStatus": "Ready to publish",
            "valueType": "STRING",
            "@type": "AttributeOracle",
            "extensible": true,
            "configurable": true,
            "minCardinality": 1,
            "maxCardinality": 1,
            "validFor": {
                "startDateTime": "2024-09-03T00:00:00.000Z"
            },
            "lastUpdate": "2025-02-17T11:46:03.948Z",
            "lastUpdatedBy": "booth",
            "created": "2025-01-20T13:31:18.705Z",
            "createdBy": "booth",
            "project": {
                "id": "DBE_RI_Mob_ProdModel_PSP",
                "name": "DBE RI Mobile Product Model",
                "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_Mob_ProdModel_PSP",
                "version": "1.0",
                "@referredType": "ProjectOracle"
            },
            "displayName": "Roaming Area",
            "characteristicValueSpecification": [
                {
                    "value": "All",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": true,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 1
                },
                {
                    "value": "US & Canada",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 2
                },
                {
                    "value": "Europe",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 3
                },
                {
                    "value": "Schengen Area",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 4
                },
                {
                    "value": "Middle East",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 5
                },
                {
                    "value": "Asia",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 6
                },
                {
                    "value": "Australia & New Zealand",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 7
                },
                {
                    "value": "National",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 8
                },
                {
                    "value": "International",
                    "valueType": "STRING",
                    "unitOfMeasure": "NONE",
                    "isDefault": false,
                    "validFor": {
                        "startDateTime": "2024-09-03T00:00:00.000Z"
                    },
                    "@type": "CharacteristicValueSpecification",
                    "sequence": 9
                }
            ]
        }
    ],
    "productSpecificationRelationship": [
        {
            "id": "PS-VOP-OFFR-CHRG-FIC",
            "href": "https://cptapcbqy.fusionapps.ocs.oc-test.com/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/productSpecification/PS-VOP-OFFR-CHRG-FIC",
            "relationshipType": "PARENT",
            "name": "VoIP Offer Charge Class",
            "version": "1.0",
            "@referredType": "ProductSpecificationOracle",
            "@type": "productSpecificationRelationship"
        }
    ],
    "usageSpecification": [
        {
            "versionState": -1,
            "id": "DBE_UsageSpec_GPRS",
            "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification/DBE_UsageSpec_GPRS",
            "name": "EventDelayedSessionTelcoGprs",
            "@referredType": "UsageSpecificationOracle",
            "@type": "UsageSpecificationRefOracle",
            "@baseType": "UsageSpecificationRef",
            "version": "1.0"
        }
    ]
}