REST Services Manager API for Billing and Revenue Management

Get Applied Customer Billing Rates

get

/appliedCustomerBillingRate

Gets the applied customer billing rates that match the query criteria.

Request

Query Parameters

@type: string

The type of object to return.

Example:

Use @type=AppliedCustomerBillingRate for a base object or @type=AppliedCustomerBillingRateOracle for an extended object.

bill.id: string
Retrieves applied customer billing rates for the specified billId.
Example:
```
bill.id=0.0.0.1+-bill+1
```
fields: string
The list of comma-separated fields to return in the response.
Example:
```
fields=bill,billingAccount
```
id: string
The ID of the applied customer billing rate to get.
Example:
```
id=0.0.0.1+-item-usage+1
```

isBilled: string

Retrieves applied customer billing rates with the specified status.

Example:

Use isBilled=true to retrieve open and closed applied customer billing rates or isBilled=false to retrieve pending applied customer billing rates.

limit: integer
The maximum number of results to return.
Example:
```
Use limit=10 to return the first 10 results only.
```
offset: integer
The number of results to offset the response by.
Example:
```
Use offset=10 to return results 10 and higher.
```

There's no request body for this operation.

Response

Supported Media Types

application/json;charset=utf-8

200 Response

Success

Headers

X-Result-Count:

The number of items returned in the response body.
X-Total-Count:

The total number of items that matched the criteria.

Root Schema : schema

Type: array

The applied customer billing rates that matched the search criteria.

Show Source

Array of: object Applied Customer Billing Rate

Title: Applied Customer Billing Rate

An applied customer billing rate.

{
    "type":"array",
    "description":"The applied customer billing rates that matched the search criteria.",
    "items":{
        "$ref":"#/components/schemas/AppliedCustomerBillingRate"
    }
}

Nested Schema : Applied Customer Billing Rate

Type: object

Title: Applied Customer Billing Rate

An applied customer billing rate.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
appliedTax: array appliedTax

The taxes applied to the applied customer billing rate.
bill: object Bill Ref

Title: Bill Ref

A reference to a bill.
billingAccount: object Billing Account Ref

Title: Billing Account Ref

A billing account is a detailed description of a bill structure.
characteristic: array characteristic

The characteristics that define the applied customer billing rate.
date: string (date-time)

Title: Applied Customer Billing Rate Created Date

The date the applied customer billing rate was created.
description: string

Title: Description

The applied customer billing rate's description.
href(required): string

Title: Applied Customer Billing Rate Href

The applied customer billing rate's href.
id(required): string

Title: Applied Customer Billing Rate ID

The applied customer billing rate's ID.
isBilled: boolean

Title: Billed

Whether the applied customer billing rate has been billed (true) or not (false). If true, also provide a value for the bill property. If false, also provide a value for the billingAccount property.
name: string

Title: Applied Customer Billing Rate Name

The applied customer billing rate's name.
periodCoverage: object TimePeriod

A period of time.
product: object Product Ref

Title: Product Ref

A reference to a product.
taxExcludedAmount: object Money

A base / value business entity used to represent money.
taxIncludedAmount: object Money

A base / value business entity used to represent money.
type: string

Title: Applied Billing Rate Type

The applied customer billing rate's type. For example, appliedBillingCharge (for recurring, one time, and usage charges), appliedBillingCredit (for rebates or product alteration credits), or appliedPenaltyCharge (for penalty charges like late fees or payment rejection fees.)

{
    "type":"object",
    "title":"Applied Customer Billing Rate",
    "description":"An applied customer billing rate.",
    "required":[
        "id",
        "href"
    ],
    "properties":{
        "id":{
            "type":"string",
            "title":"Applied Customer Billing Rate ID",
            "description":"The applied customer billing rate's ID."
        },
        "href":{
            "type":"string",
            "title":"Applied Customer Billing Rate Href",
            "description":"The applied customer billing rate's href."
        },
        "date":{
            "type":"string",
            "title":"Applied Customer Billing Rate Created Date",
            "format":"date-time",
            "description":"The date the applied customer billing rate was created."
        },
        "description":{
            "type":"string",
            "title":"Description",
            "description":"The applied customer billing rate's description."
        },
        "isBilled":{
            "type":"boolean",
            "title":"Billed",
            "description":"Whether the applied customer billing rate has been billed (<b>true</b>) or not (<b>false</b>). If true, also provide a value for the <b>bill</b> property. If false, also provide a value for the <b>billingAccount</b> property."
        },
        "name":{
            "type":"string",
            "title":"Applied Customer Billing Rate Name",
            "description":"The applied customer billing rate's name."
        },
        "type":{
            "type":"string",
            "title":"Applied Billing Rate Type",
            "description":"The applied customer billing rate's type. For example, <b>appliedBillingCharge</b> (for recurring, one time, and usage charges), <b>appliedBillingCredit</b> (for rebates or product alteration credits), or <b>appliedPenaltyCharge</b> (for penalty charges like late fees or payment rejection fees.)"
        },
        "appliedTax":{
            "type":"array",
            "description":"The taxes applied to the applied customer billing rate.",
            "items":{
                "$ref":"#/components/schemas/AppliedBillingTaxRate"
            }
        },
        "bill":{
            "description":"The bill associated with the applied customer billing rate. Specify this if <b>isBilled</b> is set to <b>true</b>.",
            "$ref":"#/components/schemas/BillRef"
        },
        "billingAccount":{
            "description":"The billing account associated with the applied customer billing rate. Specify this if <b>isBilled</b> is set to <b>false</b>.",
            "$ref":"#/components/schemas/BillingAccountRef"
        },
        "characteristic":{
            "type":"array",
            "description":"The characteristics that define the applied customer billing rate.",
            "items":{
                "$ref":"#/components/schemas/AppliedBillingRateCharacteristic"
            }
        },
        "periodCoverage":{
            "description":"The time period that the applied customer billing rate covers.",
            "$ref":"#/components/schemas/TimePeriod"
        },
        "product":{
            "description":"A product associated with the applied customer billing rate.",
            "$ref":"#/components/schemas/ProductRef"
        },
        "taxExcludedAmount":{
            "description":"The amount of the applied customer billing rate, excluding taxes.",
            "$ref":"#/components/schemas/Money"
        },
        "taxIncludedAmount":{
            "description":"The amount of the applied customer billing rate, including taxes.",
            "$ref":"#/components/schemas/Money"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    }
}

Nested Schema : appliedTax

Type: array

The taxes applied to the applied customer billing rate.

Show Source

Array of: object Applied Billing Tax Rate

Title: Applied Billing Tax Rate

The tax rate applied to a billing rate.

{
    "type":"array",
    "description":"The taxes applied to the applied customer billing rate.",
    "items":{
        "$ref":"#/components/schemas/AppliedBillingTaxRate"
    }
}

Nested Schema : Bill Ref

Type: object

Title: Bill Ref

A reference to a bill.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The actual type of the target instance when needed for disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships
@type: string

Title: Type

The object's subclass.
href(required): string

Title: Bill Href

The bill's href.
id(required): string

Title: Bill ID

The bill's ID.

{
    "type":"object",
    "title":"Bill Ref",
    "description":"A reference to a bill.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Bill ID",
            "description":"The bill's ID."
        },
        "href":{
            "type":"string",
            "title":"Bill Href",
            "description":"The bill's href."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    },
    "required":[
        "id",
        "href"
    ]
}

Nested Schema : Billing Account Ref

Type: object

Title: Billing Account Ref

A billing account is a detailed description of a bill structure.

Show Source

@baseType: string

The super-class when sub-classing.
@referredType: string

The actual type of the target instance when needed for disambiguation.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

The sub-class entity name when sub-classing.
accountNumber: string

The account number.
href: string

A reference for the billing account.
id: string

The unique ID for the billing account.
name: string

The name of the billing account.

{
    "type":"object",
    "title":"Billing Account Ref",
    "description":"A billing account is a detailed description of a bill structure.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique ID for the billing account."
        },
        "accountNumber":{
            "type":"string",
            "description":"The account number."
        },
        "href":{
            "type":"string",
            "description":"A reference for the billing account."
        },
        "name":{
            "type":"string",
            "description":"The name of the billing account."
        },
        "@baseType":{
            "type":"string",
            "description":"The super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"The sub-class entity name when sub-classing."
        },
        "@referredType":{
            "type":"string",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    }
}

Nested Schema : characteristic

Type: array

The characteristics that define the applied customer billing rate.

Show Source

Array of: object Applied Billing Rate Characteristic

Title: Applied Billing Rate Characteristic

A characteristic of an applied billing rate, based on the service type, line of business, or other parameters.

{
    "type":"array",
    "description":"The characteristics that define the applied customer billing rate.",
    "items":{
        "$ref":"#/components/schemas/AppliedBillingRateCharacteristic"
    }
}

Nested Schema : TimePeriod

Type: object

A period of time.

Show Source

endDateTime: string (date-time)

Title: End Time Period

The end of the time period in IETC-RFC-3339 format.
startDateTime: string (date-time)

Title: Start Time Period

The start of the time period in IETC-RFC-3339 format.

{
    "type":"object",
    "description":"A period of time.",
    "properties":{
        "endDateTime":{
            "type":"string",
            "format":"date-time",
            "title":"End Time Period",
            "description":"The end of the time period in IETC-RFC-3339 format."
        },
        "startDateTime":{
            "type":"string",
            "format":"date-time",
            "title":"Start Time Period",
            "description":"The start of the time period in IETC-RFC-3339 format."
        }
    }
}

Nested Schema : Product Ref

Type: object

Title: Product Ref

A reference to a product.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
href: string

Title: Product Href

The product's href.
id(required): string

Title: Product ID

The product's ID.
name: string

Title: Product Name

The product's name.

{
    "required":[
        "id"
    ],
    "type":"object",
    "title":"Product Ref",
    "description":"A reference to a product.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Product ID",
            "description":"The product's ID."
        },
        "href":{
            "type":"string",
            "title":"Product Href",
            "description":"The product's href."
        },
        "name":{
            "type":"string",
            "title":"Product Name",
            "description":"The product's name."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    }
}

Nested Schema : Money

Type: object

A base / value business entity used to represent money.

Show Source

unit(required): string

Refers to the currency (ISO4217 norm uses 3 letters to define the currency).
value(required): number (float)

A positive floating point number.

{
    "type":"object",
    "description":"A base / value business entity used to represent money.",
    "required":[
        "value",
        "unit"
    ],
    "properties":{
        "value":{
            "type":"number",
            "format":"float",
            "description":"A positive floating point number."
        },
        "unit":{
            "type":"string",
            "description":"Refers to the  currency (ISO4217 norm uses 3 letters to define the currency)."
        }
    }
}

Nested Schema : Applied Billing Tax Rate

Type: object

Title: Applied Billing Tax Rate

The tax rate applied to a billing rate.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
taxAmount: object Money

A base / value business entity used to represent money.
taxCategory: string

Title: Tax Category

The applied billing tax's category.
taxRate: number (float)

Title: Tax Rate

The applied billing tax rate.

{
    "type":"object",
    "title":"Applied Billing Tax Rate",
    "description":"The tax rate applied to a billing rate.",
    "properties":{
        "taxCategory":{
            "type":"string",
            "title":"Tax Category",
            "description":"The applied billing tax's category."
        },
        "taxRate":{
            "type":"number",
            "title":"Tax Rate",
            "format":"float",
            "description":"The applied billing tax rate."
        },
        "taxAmount":{
            "description":"The applied billing tax amount.",
            "$ref":"#/components/schemas/Money"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    }
}

Nested Schema : Applied Billing Rate Characteristic

Type: object

Title: Applied Billing Rate Characteristic

A characteristic of an applied billing rate, based on the service type, line of business, or other parameters.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Scheme Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
name(required): string

Title: Characteristic Name

The characteristic's name.
value(required): object Any
valueType: string

Title: Characteristic Type

The data type of the characteristic's value.

{
    "type":"object",
    "title":"Applied Billing Rate Characteristic",
    "description":"A characteristic of an applied billing rate, based on the service type, line of business, or other parameters.",
    "required":[
        "name",
        "value"
    ],
    "properties":{
        "name":{
            "type":"string",
            "title":"Characteristic Name",
            "description":"The characteristic's name."
        },
        "valueType":{
            "type":"string",
            "title":"Characteristic Type",
            "description":"The data type of the characteristic's value."
        },
        "value":{
            "description":"The characteristic's value.",
            "$ref":"#/components/schemas/Any"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Scheme Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    }
}

Nested Schema : Any

Type: object

400 Response

Bad Request

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

401 Response

Unauthorized

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

403 Response

Forbidden

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

404 Response

Not Found

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

405 Response

Method Not allowed

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

409 Response

Conflict

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

500 Response

Internal Server Error

Root Schema : Error

Type: object

This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).

Show Source

@baseType: string

This defines the super-class when sub-classing.
@schemaLocation: string (uri)

A URI to a JSON-schema file that defines additional attributes and relationships.
@type: string

This defines the sub-class entity name when sub-classing.
code(required): string

Refers to application relevant detail, defined in the API or a common list.
message: string

More details and corrective actions related to the error which can be shown to a client user.
reason(required): string

Explanation of the reason for the error which can be shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Displays the HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Refers to application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error which can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which can be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"Displays the HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"This defines the super-class when sub-classing."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"This defines the sub-class entity name when sub-classing."
        }
    },
    "description":"This is used when an API throws an error, typically with a HTTP error response-code (<b>3xx, 4xx, 5xx</b>)."
}

Examples

The following example shows how to get applied customer billing rates by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.

The request uses the offset and limit query parameters to restrict the results.

curl -X GET 'http://host:port/brm/customerBillManagement/version/appliedCustomerBillingRate?offset=5&limit=2'

Example of the Response Body

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

[
    {
        "id": "0.0.0.1+-item-cycle_forward+108525",
        "href": "http://host:port/brm/customerBillManagement/version/appliedCustomerBillingRate/0.0.0.1+-item-cycle_forward+108525",
        "date": "2020-05-02T01:14:14-07:00",
        "description": null,
        "isBilled": false,
        "name": "Cycle forward",
        "type": "/item/cycle_forward",
        "appliedTax": null,
        "bill": {
            "id": "0.0.0.1+-bill+106861",
            "href": "http://host:port/brm/customerBillManagement/version/customerBill/0.0.0.1+-bill+106861",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": "BillRef",
            "@referredType": "CustomerBill"
        },
        "billingAccount": {
            "id": "0.0.0.1+-account+107117",
            "href": null,
            "name": "Tanya K",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": "BillingAccountRef",
            "@referredType": "billingAccount"
        },
        "characteristic": null,
        "periodCoverage": null,
        "product": null,
        "taxExcludedAmount": {
            "unit": "EUR",
            "value": 45.0
        },
        "taxIncludedAmount": {
            "unit": "EUR",
            "value": 45.0
        },
        "@baseType": "AppliedCustomerBillingRate",
        "@schemaLocation": null,
        "@type": "AppliedCustomerBillingRate",
    },
    {
        "id": "0.0.0.1+-item-misc+107373",
        "href": "http://host:port/brm/customerBillManagement/version/appliedCustomerBillingRate/0.0.0.1+-item-misc+107373",
        "date": "2020-05-02T01:14:13-07:00",
        "description": null,
        "isBilled": false,
        "name": "Usage",
        "type": "/item/misc",
        "appliedTax": null,
        "bill": {
            "id": "0.0.0.1+-bill+106861",
            "href": "http://host:port/brm/customerBillManagement/version/customerBill/0.0.0.1+-bill+106861",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": "BillRef",
            "@referredType": "CustomerBill"
        },
        "billingAccount": {
            "id": "0.0.0.1+-account+107117",
            "href": null,
            "name": "Tanya Levy",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": "BillingAccountRef",
            "@referredType": "billingAccount"
        },
        "characteristic": null,
        "periodCoverage": null,
        "product": null,
        "taxExcludedAmount": {
            "unit": "EUR",
            "value": 0.0
        },
        "taxIncludedAmount": {
            "unit": "EUR",
            "value": 0.0
        },
        "@baseType": "AppliedCustomerBillingRate",
        "@schemaLocation": null,
        "@type": "AppliedCustomerBillingRate",
    }
]