Get all projects
get
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project
This operation list or find Project entities
Request
Query Parameters
-
description: string
The description of the resource.
-
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.
-
version: string
The current version of the resource.
-
whereUsed: string
enrich objects with usedBy information
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
OK
Root Schema : ProjectOracle
Title:
ProjectOracle
Is a detailed description of the project
Match All
Is a detailed description of the project
Is a detailed description of the project
Show Source
-
object
Project
Title:
Project
Discriminator:{ "propertyName":"@type", "mapping":{ "Project":"#/components/schemas/Project", "ProjectOracle":"#/components/schemas/ProjectOracle" } }
Is a detailed description of the project -
object
ProjectOracle-allOf[1]
Nested Schema : Project
Type:
object
Title:
Project
Discriminator: @type
Discriminator Values
Is a detailed description of the project
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type: string
When sub-classing, this defines the sub-class entity name
-
description: string
A narrative that describes the project
-
href: string
Reference of the Project
-
id: string
Maximum Length:
30
Unique identifier of the Project -
lastUpdate: string
(date-time)
Date and time of the last update
-
lifecycleStatus: string
Used to indicate the current lifecycle status
-
name(required): string
Name of the project
-
version: string
Version of the object
Nested Schema : ProjectOracle-allOf[1]
Type:
Show Source
object
-
action: string
Used to indicate the last action performed on the project
-
applicationName: string
name of the external application
-
approvalEnabled: boolean
approval enabled flag
-
approvalHistory: array
approvalHistory
-
created: string
(date-time)
Date and time of the creation
-
createdBy: string
name of the person who created item
-
currentStatus: string
Used to indicate the current status before state change.
-
externalId: string
id of the external application
-
lastUpdatedBy: string
name of the person who updated item
-
launchedDate: string
(date-time)
Date and time of project launched
-
lifecycleConfiguration: object
LifecycleConfigurationRef
Title:
LifecycleConfigurationRef
LifecycleConfiguration Reference -
projectHistory: array
projectHistory
-
projectItems: array
projectItems
Contains the list of Catalog Objects
-
publishJobRef: object
PublishJobRef
Title:
PublishJobRef
Publish Job reference. A Job describes the details of the publishing state -
subStatus: string
sub status code
-
targetReleaseDate: string
(date)
Date of targeted release of project
-
versionState: number
Version state of the project
Nested Schema : approvalHistory
Type:
Show Source
array
-
Array of:
object ApprovalHistory
Title:
ApprovalHistory
Nested Schema : LifecycleConfigurationRef
Type:
object
Title:
LifecycleConfigurationRef
LifecycleConfiguration Reference
Show Source
-
@referredType: string
Class type of the lifecycle configuration
-
href: string
A string. Reference of the lifecycle configuration.
-
id: string
Maximum Length:
100
A string. Unique identifier of the lifecycle configurations. -
name: string
A string. Name of the lifecycle configuration.
-
version: string
A string. lifecycle configuration version.
Nested Schema : projectHistory
Type:
Show Source
array
-
Array of:
object ProjectHistory
Title:
ProjectHistory
Nested Schema : projectItems
Type:
array
Contains the list of Catalog Objects
Show Source
-
Array of:
object PublishJobRef
Title:
PublishJobRef
Project Item reference. A project Item ref represents entities that can be ProductOffering or ProductOfferingSpecification or ProductOfferingPrice etc..
Nested Schema : PublishJobRef
Type:
object
Title:
PublishJobRef
Publish Job reference. A Job describes the details of the publishing state
Show Source
-
@referredType: string
The actual type of the target instance when needed for disambiguation.
-
href: string
URL serving as reference for the Job resource
-
id(required): string
Unique-Identifier for this publish Job
Nested Schema : ApprovalHistory
Type:
object
Title:
Show Source
ApprovalHistory
-
approvalAction: string
A string. approval action.
-
approvalDate: string
(date-time)
A date time (DateTime). Date and time of the approval.
-
approvalFor: string
A string. approval for.
-
approver: string
A string. approver.
-
comments: string
A string. A narrative that explains in detail what the approval history is.
-
entityName: string
Maximum Length:
100
A string. Entity name. -
id(required): string
Maximum Length:
100
A string. Unique identifier of the approval history. -
projectId: string
Maximum Length:
100
A string. Unique identifier of the project id. -
projectName: string
Maximum Length:
100
A string. Project Name. -
requestor: string
A string. requestor.
Nested Schema : ProjectHistory
Type:
object
Title:
Show Source
ProjectHistory
-
action: string
A string. action.
-
entityName: string
Maximum Length:
100
A string. Entity Name. -
id(required): string
Maximum Length:
100
A string. Unique identifier of the project history. -
stateFrom: string
A string. State From.
-
stateTo: string
A string. State To.
Nested Schema : PublishJobRef
Type:
object
Title:
PublishJobRef
Project Item reference. A project Item ref represents entities that can be ProductOffering or ProductOfferingSpecification or ProductOfferingPrice etc..
Show Source
-
@refBaseType: string
The TMF base type of the target instance when needed for disambiguation.
-
@referredType(required): string
The actual type of the target instance when needed for disambiguation.
-
context: array
context
-
entitlementType: string
Allowed Values:
[ "ENTITLEMENT_PRICING", "ENTITLEMENT_SERVICE" ]
entitlememt type -
href: string
Reference of the related entity.
-
id(required): string
Unique identifier of a related entity.
-
lifecycleStatus: string
The lifecycleStatus of the related entity.
-
name: string
Name of the related entity.
-
priceType: string
Allowed Values:
[ "RECURRING", "ONE_TIME", "USAGE", "ALTERATION", "ALLOWANCE", "OVERAGE", "PENALTY", "ONE_TIME_PRICE_PLAN", "RECURRING_PRICE_PLAN", "USAGE_PRICE_PLAN", "ALTERATION_PRICE_PLAN", "OVERAGE_PRICE_PLAN", "COUNTER" ]
Describes the price, such as recurring, discount, allowance, penalty, and so forth -
productType: string
Allowed Values:
[ "PACKAGE", "COMMERCIAL_BUNDLE", "SERVICE_BUNDLE", "SERVICE", "DEVICE", "ACCESSORY", "CHOICE", "AGGREGATION", "SYSTEM_OFFER" ]
Used to indicate the type of product. -
profileType: string
Allowed Values:
[ "DEVICE_SPEC", "BUSINESS_CONFIG", "TRADE_IN", "CHARGING_TERM", "SUSPENSION_TERM", "RETURN_CHECKLIST", "ENTITY_PROFILE", "RENEWAL_TERM", "FINANCE_PLAN", "ZONE_VALUE_MAP" ]
type of the profile -
promotionType: string
Allowed Values:
[ "AWARD", "DISCOUNT", "TRADE_IN", "CROSS_PRODUCT_DISCOUNT" ]
Comma seperated promotion tags/type -
ruleType: string
Allowed Values:
[ "COMPATIBILITY", "ELIGIBILITY", "MIGRATION", "RECOMMENDATION", "CONSTRAINT" ]
-
version: string
Version of the object
Nested Schema : context
Type:
Show Source
array
-
Array of:
object ProjectItemContextsOracle
Title:
ProjectItemContextsOracle
Project item context objects which holds the KPI parameters
Nested Schema : ProjectItemContextsOracle
Type:
object
Title:
ProjectItemContextsOracle
Project item context objects which holds the KPI parameters
Show Source
-
params(required): array
params
-
type(required): string
Allowed Values:
[ "ACQUISITION", "RETENTION" ]
Used to indicate the context type
Nested Schema : params
Type:
Show Source
array
-
Array of:
object ProjectItemContextParamsOracle
Title:
ProjectItemContextParamsOracle
Project item context KPI parameters
Nested Schema : ProjectItemContextParamsOracle
Type:
object
Title:
ProjectItemContextParamsOracle
Project item context KPI parameters
Show Source
-
key(required): string
Key of the context parameter.
-
name(required): string
Name of the context parameter.
-
value(required): string
Value of the context parameter.
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
403 Response
You don't have authorization to perform this 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
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
409 Response
The request can't be completed due to a conflict with the current state of the resource.
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 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/v4/project \ -H 'Content-Type: application/json'
Example of Response Body
The following example shows the contents of the response body in JSON format.
[ { "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/Automation_project1594120527902", "id": "Automation_project1594120527902", "createdBy": "anonymous", "created": "2020-07-07T11:16:57.001Z", "lastUpdate": "2020-07-07T11:16:57.684Z", "lastUpdatedBy": "anonymous", "version": "1.0", "@type": "ProjectOracle", "lifecycleStatus": "In design", "name": "Automation_project1594120527902", "description": "Automation_project1594120527902 Description", "action": "CREATE_OBJECT" }, { "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/28465", "id": "28465", "createdBy": "booth", "created": "2020-07-23T08:19:30.003Z", "lastUpdate": "2020-07-23T08:19:31.553Z", "lastUpdatedBy": "booth", "version": "1.0", "@type": "ProjectOracle", "@schemaLocation": "https://{FusionAppsHost}/CatalogManagement/schema/oracle/ProjectOracle.yml", "lifecycleStatus": "In design", "name": "ImportJob_28465", "description": "Project for Import Job Id 28465", "action": "Import_Job", "projectItems": [ { "id": "Bundlepopp121234", "@referredType": "ProductOfferingPriceOracle", "name": "Bundle popp121234", "version": "1.0" }, { "id": "POPFirst", "@referredType": "ProductOfferingPriceOracle", "name": "POP First", "version": "1.0" }, { "id": "POPSecond", "@referredType": "ProductOfferingPriceOracle", "name": "POP Second", "version": "1.0" } ] }, .... ]