Page Comparison

...

Tip
Available from CRM.COM R8.0.0

Excerpt
This method returns the usage service catalogs that are allowed to be used in the system. Multiple usage service catalogs are returned by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

life_cycle_state

(optional)

String

If specified then only usage service catalogs having a life cycle state equal to the specified value will be retrieved. The supported values are DRAFT, EFFECTIVE, NOT_EFFECTIVE or CANCELLED

Tip

From CRM.COM R16.1.0, CANCELLED is deprecated

From CRM.COM R17.0.0, DRAFT is deprecated

valid_as_of_date

(optional)

Date

If specified then only usage service catalogs which are valid on that date will be retrieved.

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

If specified then only usage service catalogs related with the specified provisioning provider will be retrieved. The allowed provisioning provider identifier fields are the following:

Include Page

	V4:provisioning_provider_identifier
	V4:provisioning_provider_identifier

Tip
Deprecated from CRM.COM R16.1.0

accounts_receivable_identifier

(optional)

Accounts Receivable Identifier

If specified then the only usage service catalogs which can be provided to the specified accounts receivable will be retrieved. The allowed accounts receivable identifier fields are the following:

Include Page

	V4:accounts_receivable_identifier
	V4:accounts_receivable_identifier

subscription_identifier

(optional)

Subscription Identifier

If specified then the only usage service catalogs which can be provided to the specified subscription will be retrieved. The allowed subscription identifier fields are the following:

Include Page

	V4:subscription_identifier
	V4:subscription_identifier

termed_service_identifier

(optional)

Product Identifier

If specified then the only usage service catalogs which can be provided to the specified termed service will be retrieved. The allowed termed service identifier fields are the following:

Include Page

	V4:product_identifier
	V4:product_identifier

group_identifier

(optional)

Group Identifier

The identifier of the group that will be using the usage service catalog. The group is filtered against the usage service catalog's allowed organisational units. The allowed group identifier fields are the following:

Include Page

	V4:group_identifier
	V4:

group_identifier

Tip
Deprecated from CRM.COM R18.0.0

unit_identifier

(optional)

Unit Identifier

The identifier of the unit that will be using the usage service catalog. The unit is filtered against the usage service catalog's allowed organisational units. The allowed unit identifier fields are the following:

Include Page

	V4:unit_identifier
	V4:unit_identifier

currency

Tip
Deprecated from CRM.COM R18.0.0

business_unit_identifier

(optional)

Currency

Business Unit Identifier

The identifier of

the currency of the retrieved Usage Service Catalog. The available currency

the business unit that will be using the usage service catalog. The business unit is filtered against the usage service catalog's allowed organisational units. The allowed business unit identifier fields are the following:

Include Page

	V4:

currency

business_unit_identifier
	V4:

currency

business_unit_identifier

Tip
Available from CRM.COM

R14

R18.

2

0.0

number_of_results

(optional)

Number

The number of results that can be retrieved through each call

Tip
Available from CRM.COM R13.0.0

offset

(optional)

Number

Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number

Tip
Available from CRM.COM R13.0.0

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one semi-optional parameter can be specified.

...

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

code

language

javascript
theme	Confluence	language	javascript
linenumbers	true

{
    "status":
    {
        "message": "",
        "description": "",
        "code": "OK"
    },
    "data":
    [
        {
            "log_information":
            {
                "updated_date": "2015-09-11T10:23:52",
                "created_date": "2015-09-10T09:42:40",
                "created_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "updated_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                }
            },
            "provisioning_provider":
            {
                "provisioning_protocol": "CONAX_CONTEGO_WEB_SERVICES",
                "id": "9C4930E3523BD2C8F0B513035322C423",
                "name": "CONAX V5",
                "description": "CONAX Contego 3.0 Web Services
connectSMS: Use to test the CA PIN update command
smsWs06: All othe",
                "alternative_code": "CV5"
            },
            "life_cycle_state": "EFFECTIVE",
            "validity_set":
            [
            ],
            "id": "560F0B98AC8A4E07A1713892B16D420E",
            "name": "Conax Catalog1 ",
            "description": null,
            "alternative_code": "Conax_1"
        },
        {
            "log_information":
            {
                "updated_date": "2015-09-17T14:43:36",
                "created_date": "2015-09-11T11:38:42",
                "created_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "updated_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                }
            },
            "provisioning_provider":
            {
                "provisioning_protocol": "CONAX_CONTEGO_WEB_SERVICES",
                "id": "9C4930E3523BD2C8F0B513035322C423",
                "name": "CONAX V5",
                "description": "CONAX Contego 3.0 Web Services
connectSMS: Use to test the CA PIN update command
smsWs06: All othe",
                "alternative_code": "CV5"
            },
            "life_cycle_state": "EFFECTIVE",
            "validity_set":
            [
            ],
            "id": "5E5AD41E3939402085F421612C20B0A9",
            "name": "test l",
            "description": null,
            "alternative_code": "tl"
        },
        {
            "log_information":
            {
                "updated_date": "2015-09-11T14:47:56",
                "created_date": "2015-09-11T14:47:49",
                "created_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "updated_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                }
            },
            "provisioning_provider":
            {
                "provisioning_protocol": "CONAX_CONTEGO_WEB_SERVICES",
                "id": "9C4930E3523BD2C8F0B513035322C423",
                "name": "CONAX V5",
                "description": "CONAX Contego 3.0 Web Services
connectSMS: Use to test the CA PIN update command
smsWs06: All othe",
                "alternative_code": "CV5"
            },
            "life_cycle_state": "DRAFT",
            "validity_set":
            [
            ],
            "id": "497F1FE2EB634D75A555C610B1FD0E8F",
            "name": null,
            "description": null,
            "alternative_code": null
        },
        {
            "log_information":
            {
                "updated_date": "2015-09-14T14:42:49",
                "created_date": "2015-09-11T14:48:05",
                "created_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "updated_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                }
            },
            "provisioning_provider":
            {
                "provisioning_protocol": "CONAX_CONTEGO_WEB_SERVICES",
                "id": "9C4930E3523BD2C8F0B513035322C423",
                "name": "CONAX V5",
                "description": "CONAX Contego 3.0 Web Services
connectSMS: Use to test the CA PIN update command
smsWs06: All othe",
                "alternative_code": "CV5"
            },
            "life_cycle_state": "EFFECTIVE",
            "validity_set":
            [
            ],
            "id": "BA2F98BF66494A3584ABE9DA1747BA16",
            "name": "Catalog Story board 5",
            "description": null,
            "alternative_code": "Catalog_SB_5"
        },
        {
            "log_information":
            {
                "updated_date": "2015-09-17T11:57:47",
                "created_date": "2015-09-17T11:47:46",
                "created_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "updated_by_unit":
                {
                    "community_name": "Internal Community",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "name": "Admin Unit",
                    "group_name": "Main Group",
                    "description": "r1 Test Description for resource  request tab.Test Description for resource  request tab.",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "sakkascy1986@hotmail.com"
                }
            },
            "provisioning_provider":
            {
                "provisioning_protocol": "EXSET_SMS_SERVICES",
                "id": "1007A2DB26CF47E396E210FE85EFF839",
                "name": "Exset",
                "description": "Exset
Oracle XE 10.2",
                "alternative_code": "XE"
            },
            "life_cycle_state": "DRAFT",
            "validity_set":
            [
                {
                    "id": "0C8DAE72EAED47A0BB23B227CBC619C7",
                    "valid_from": "2015-10-01T00:00:00",
                    "valid_to": null
                },
                {
                    "id": "DFC0F011D12940A4A2C231A53BAEF49D",
                    "valid_from": "2015-09-01T00:00:00",
                    "valid_to": "2015-09-30T00:00:00"
                }
            ],
            "id": "65407FBD15184DEAA6E5AC84EEBD558D",
            "name": "Exet Usage Catalog",
            "description": null,
            "alternative_code": "EUC"
        }
    ]
}

...

Versions Compared

Old Version 3

New Version Current

Key

Resource URL

Parameters

Restrictions