Get Usage
get
/usage
Gets the usage resource that matches the specified query criteria.
Request
Query Parameters
-
@type: string
The type of object to return.Example:
Use @type=Usage for a base object, or @type=UsageOracle for an extended object.
-
description: string
Retrieves the usage whose description matches the specified description.Example:
description=Cycle Forward Fees (srvc):Standard GSM Telephony
-
description.like: string
Retrieves the usage whose description is similar to the specified description.Example:
description.like=Cycle Forward Fees (srvc):Standard GSM Telephony
-
fields: string
The list of fields to return in the response.Example:
fields=type,status
-
id: string
The ID of the usage to get.Example:
id=0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+32341474824064940
-
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.
-
usageDate: string
Retrieves the usage with a date that is equal to the specified dateTime.Example:
usageDate=2020-01-01T04:00:27-08:00
-
usageDate.gt: string
Retrieves the usage with a date that is greater than the specified dateTime.Example:
usageDate.gt=2020-01-01T04:00:27-08:00
-
usageDate.gte: string
Retrieves the usage with a date that is greater than or equal to the specified dateTime.Example:
usageDate.gte=2020-01-01T04:00:27-08:00
-
usageDate.lt: string
Retrieves the usage whose date is less than the specified dateTime.Example:
usageDate.lt=2020-01-01T04:00:27-08:00
-
usageDate.lte: string
Retrieves the usage with a date that is less than or equal to the specified dateTime.Example:
usageDate.lte=2020-01-01T04:00:27-08:00
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The usage was returned successfully.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object Usage
Title:
Usage
A instance of usage.
Nested Schema : Usage
Type:
object
Title:
Usage
A instance of usage.
Show Source
-
@baseType: string
The object's superclass.
-
@schemaLocation: string
(uri)
A URI to a JSON schema file that defines additional attributes and relationships.
-
@type: string
The object's subclass.
-
description: string
Title:
Usage Description
The usage's description -
href: string
(uri)
Title:
Usage Href
The usage's href. -
id: string
Title:
Usage ID
The usage's ID. -
ratedProductUsage: array
ratedProductUsage
The usage's rating details.
- relatedParty: array relatedParty
-
status: string
Title:
Usage Status
Allowed Values:[ "received", "rejected", "recycled", "guided", "rated", "rerated", "billed" ]
The usage's status. -
usageCharacteristic: array
usageCharacteristic
The usage's characteristics.
-
usageDate: string
(date-time)
Title:
Usage Date
The usage's date. -
usageSpecification: object
Usage Specification Ref
Title:
Usage Specification Ref
A usage specification reference. -
usageType: string
Title:
Usage Type
The usage's type.
Nested Schema : ratedProductUsage
Type:
array
The usage's rating details.
Show Source
-
Array of:
object Rated Product Usage
Title:
Rated Product Usage
An instance of rated usage.
Nested Schema : usageCharacteristic
Type:
array
The usage's characteristics.
Show Source
-
Array of:
object Usage Characteristic
Title:
Usage Characteristic
A characteristic of usage.
Nested Schema : Usage Specification Ref
Type:
object
Title:
Usage Specification Ref
A usage specification reference.
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
(uri)
Title:
Usage Specification Href
The usage specification's href. -
id(required): string
Title:
Usage Specification ID
The usage specification's ID. -
name: string
Title:
Usage Specification Name
The usage specification's name.
Nested Schema : Rated Product Usage
Type:
object
Title:
Rated Product Usage
An instance of rated usage.
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. -
bucketValueConvertedInAmount: object
Money
A base / value business entity used to represent money.
-
isBilled: boolean
Title:
Is Billed
Whether the usage has been billed (true) or not (false). -
isTaxExempt: boolean
Title:
Is Tax Exempt
Whether the usage is tax exempt (true) or not (false). -
offerTariffType: string
Title:
Offer Tariff Type
The tariff's type. -
productRef: object
Product Ref
Title:
Product Ref
A reference to a product. -
ratingAmountType: string
Title:
Rating Amount Type
The rating amount's type. -
ratingDate: string
(date-time)
Title:
Rating Date
The date the usage was rated. -
taxExcludedRatingAmount: object
Money
A base / value business entity used to represent money.
-
taxIncludedRatingAmount: object
Money
A base / value business entity used to represent money.
-
taxRate: number
(float)
Title:
Tax Rate
The tax rate. -
usageRatingTag: string
Title:
Usage Rating Tag
The usage rating's tag.
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.
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.
Nested Schema : Related Party
Type:
object
Title:
Related Party
A party related to another object.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType(required): 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:
Href
The party's href. -
id(required): string
Title:
Party ID
The party's ID. -
name: string
Title:
Party Name
The party's name. -
role: string
Title:
Party Role
The party's role.
Nested Schema : Usage Characteristic
Type:
object
Title:
Usage Characteristic
A characteristic of usage.
Show Source
-
@baseType: string
The object's superclass.
-
@schemaLocation: string
(uri)
A URI to a JSON schema file that defines additional attributes and relationships.
-
@type: string
The object's subclass.
-
characteristicRelationship: array
characteristicRelationship
The characteristic's relationships.
-
id: string
The usage characteristic's ID.
-
name(required): string
Title:
Usage Characteristic Name
The characteristic's name. -
value(required): object
Any
-
valueType: string
The type of the characteristic's value.
Nested Schema : characteristicRelationship
Type:
array
The characteristic's relationships.
Show Source
-
Array of:
object CharacteristicRelationship
A related characteristic.
Nested Schema : Any
Type:
object
Nested Schema : CharacteristicRelationship
Type:
object
A related characteristic.
Show Source
-
@baseType: string
The object's superclass.
-
@schemaLocation: string
(uri)
A URI to a JSON schema file that defines additional attributes and relationships.
-
@type: string
The object's subclass.
-
href: string
(uri)
The characteristic relationship's href.
-
id: string
The characteristic relationship's ID.
-
relationshipType: string
The type of characteristic relationship.
400 Response
Request error
500 Response
Unexpected server error
Examples
The following example shows how to get usage by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.
The request uses the limit query parameter to limit the results.
curl -X GET 'http://host:port/brm/usageManagement/version/usage?limit=2'
Example of the Response Body
The following example shows the contents of the response body in JSON format.
[ { "@baseType": "Usage", "@schemaLocation": null, "@type": "Usage", "id": "0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+326088760519522593", "href": "http://host:port/brm/usageManagement/version/usage/0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+326088760519522593", "date": "2020-08-14T00:00:00-07:00", "type": "EventBillingProductFeeCycleCycle_forward_monthly", "status": "Rated", "usageSpecification": null, "usageCharacteristic": null, "relatedParty": null, "ratedProductUsage": [ { "@baseType": null, "@schemaLocation": null, "@type": null, "ratingDate": "2020-08-14T00:00:00-07:00", "usageRatingTag": "Rate 1", "isBilled": null, "ratingAmountType": null, "taxExcludedAmount": { "unit": "USD", "value": 20.0 }, "taxIncludedAmount": { "unit": "USD", "value": 20.0 }, "taxRate": 0.0, "isTaxExempt": null, "offerTariffType": null, "bucketValueConvertedInAmount": null, "productRef": null } ] }, { "@baseType": "Usage", "@schemaLocation": null, "@type": "Usage", "id": "0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+326088760519524129", "href": "http://host:port/brm/usageManagement/version/usage/0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+326088760519524129", "date": "2020-09-14T00:00:00-07:00", "type": "EventBillingProductFeeCycleCycle_forward_monthly", "status": "Rated", "usageSpecification": null, "usageCharacteristic": null, "relatedParty": null, "ratedProductUsage": [ { "ratingDate": "2020-09-14T00:00:00-07:00", "usageRatingTag": "Rate 1", "isBilled": null, "ratingAmountType": null, "taxExcludedAmount": { "unit": "USD", "value": 40.0 }, "taxIncludedAmount": { "unit": "USD", "value": 40.0 }, "taxRate": 0.0, "isTaxExempt": null, "offerTariffType": null, "bucketValueConvertedInAmount": null, "productRef": null } ] } ]