Jump to

• Request
• Response
• Examples

Get Usage by ID

get

/usage/{id}

This operation retrieves a Usage entity. Attribute selection is enabled for all first level attributes.

Request

Path Parameters

• id(required): string
  The identifier of the Usage.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json;charset=utf-8

200 Response

The request was successful.

Body ()

Root Schema : Usage

Type: object

An occurrence of employing a Product, Service, or Resource for its intended purpose, which is of interest to the business and can have charges applied to it. It is comprised of characteristics, which represent attributes of usage.

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 Extensible name.
• adjustedAmount: object Money
  Represents a monetary amount.
• appliedCustomerBillingRate: object appliedCustomerBillingRate
  The applied customer billing rate associated with the usage.
• bill: object bill
  The bill associated with the usage.
• billingAccount: object billingAccount
  The billing account associated with the usage.
• billStructure: object billStructure
  The bill structure associated with the usage.
• bytesIn: integer
  The number of incoming bytes.
• bytesOut: integer
  The number of outgoing bytes.
• calledToNumber: string
  The called telephone number.
• cycleEnd: string (date-time)
  The end date and time of the cycle.
• cycleStart: string (date-time)
  The start date and time of the cycle.
• description: string
  The description of the usage.

  Example: Voicemail Retrieval
• discount: object Money
  Represents a monetary amount.
• disputedAmount: object Money
  Represents a monetary amount.
• effectiveDate: string (date-time)
  The date and time when the usage became effective.
• endTime: string (date-time)
  The end date and time of the usage.
• href: string (uri)
  The hyperlink reference.
• id: string
  The unique identifier.
• nonCurrencyDetails: array nonCurrencyDetails
  The rated details for non-currency resources.
• quantity: number (double)
  The consumed quantity.
• ratedProductUsage: array ratedProductUsage
• remainingAmount: object Money
  Represents a monetary amount.
• rumName: string
  The rating unit of measure name.
• service: object service
  The service associated with the usage.
• settledDisputeAmount: object Money
  Represents a monetary amount.
• taxAmount: object Money
  Represents a monetary amount.
• usageDate: string (date-time)
  The date of the usage.

  Example: 2020-09-21T09:13:16-07:00
• usageType: string
  The type of usage.

{
    "type":"object",
    "description":"An occurrence of employing a Product, Service, or Resource for its intended purpose, which is of interest to the business and can have charges applied to it. It is comprised of characteristics, which represent attributes of usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        },
        "href":{
            "type":"string",
            "format":"uri",
            "description":"The hyperlink reference."
        },
        "description":{
            "example":"Voicemail Retrieval",
            "type":"string",
            "description":"The description of the usage."
        },
        "appliedCustomerBillingRate":{
            "type":"object",
            "description":"The applied customer billing rate associated with the usage.",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"The unique identifier."
                }
            }
        },
        "bill":{
            "type":"object",
            "description":"The bill associated with the usage.",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"The unique identifier."
                }
            }
        },
        "billStructure":{
            "type":"object",
            "description":"The bill structure associated with the usage.",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"The unique identifier."
                }
            }
        },
        "billingAccount":{
            "type":"object",
            "description":"The billing account associated with the usage.",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"The unique identifier."
                }
            }
        },
        "bytesIn":{
            "type":"integer",
            "description":"The number of incoming bytes."
        },
        "bytesOut":{
            "type":"integer",
            "description":"The number of outgoing bytes."
        },
        "calledToNumber":{
            "type":"string",
            "description":"The called telephone number."
        },
        "cycleEnd":{
            "type":"string",
            "format":"date-time",
            "description":"The end date and time of the cycle."
        },
        "cycleStart":{
            "type":"string",
            "format":"date-time",
            "description":"The start date and time of the cycle."
        },
        "effectiveDate":{
            "type":"string",
            "format":"date-time",
            "description":"The date and time when the usage became effective."
        },
        "endTime":{
            "type":"string",
            "format":"date-time",
            "description":"The end date and time of the usage."
        },
        "nonCurrencyDetails":{
            "type":"array",
            "description":"The rated details for non-currency resources.",
            "items":{
                "$ref":"#/components/schemas/NonCurrencyDetail"
            }
        },
        "quantity":{
            "type":"number",
            "format":"double",
            "description":"The consumed quantity."
        },
        "rumName":{
            "type":"string",
            "description":"The rating unit of measure name."
        },
        "service":{
            "type":"object",
            "description":"The service associated with the usage.",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"The unique identifier."
                }
            }
        },
        "usageDate":{
            "example":"2020-09-21T09:13:16-07:00",
            "type":"string",
            "format":"date-time",
            "description":"The date of the usage."
        },
        "usageType":{
            "type":"string",
            "description":"The type of usage."
        },
        "ratedProductUsage":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/RatedProductUsage"
            }
        },
        "taxAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "adjustedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "remainingAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "discount":{
            "$ref":"#/components/schemas/Money"
        },
        "disputedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "settledDisputeAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "format":"uri",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        }
    }
}

Nested Schema : Money

Type: object

Represents a monetary amount.

Show Source

• unit: string
  The currency's ISO 4217 three-letter code.
• value: number (double)
  A signed floating-point number whose sign depends on the API context.

{
    "type":"object",
    "description":"Represents a monetary amount.",
    "properties":{
        "unit":{
            "type":"string",
            "nullable":true,
            "description":"The currency's ISO 4217 three-letter code."
        },
        "value":{
            "type":"number",
            "nullable":true,
            "format":"double",
            "description":"A signed floating-point number whose sign depends on the API context."
        }
    }
}

Nested Schema : appliedCustomerBillingRate

Type: object

The applied customer billing rate associated with the usage.

Show Source

• id: string
  The unique identifier.

{
    "type":"object",
    "description":"The applied customer billing rate associated with the usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        }
    }
}

Nested Schema : bill

Type: object

The bill associated with the usage.

Show Source

• id: string
  The unique identifier.

{
    "type":"object",
    "description":"The bill associated with the usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        }
    }
}

Nested Schema : billingAccount

Type: object

The billing account associated with the usage.

Show Source

• id: string
  The unique identifier.

{
    "type":"object",
    "description":"The billing account associated with the usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        }
    }
}

Nested Schema : billStructure

Type: object

The bill structure associated with the usage.

Show Source

• id: string
  The unique identifier.

{
    "type":"object",
    "description":"The bill structure associated with the usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        }
    }
}

Nested Schema : nonCurrencyDetails

Type: array

The rated details for non-currency resources.

Show Source

• Array of: object NonCurrencyDetail
  Rated details for a non-currency resource.

{
    "type":"array",
    "description":"The rated details for non-currency resources.",
    "items":{
        "$ref":"#/components/schemas/NonCurrencyDetail"
    }
}

Nested Schema : ratedProductUsage

Type: array

Show Source

• Array of: object RatedProductUsage
  An occurrence of employing a product for its intended purpose with all rating details.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/RatedProductUsage"
    }
}

Nested Schema : service

Type: object

The service associated with the usage.

Show Source

• id: string
  The unique identifier.

{
    "type":"object",
    "description":"The service associated with the usage.",
    "properties":{
        "id":{
            "type":"string",
            "description":"The unique identifier."
        }
    }
}

Nested Schema : NonCurrencyDetail

Type: object

Rated details for a non-currency resource.

Show Source

• originalNetAmount: number (double)
  The original net amount.
• priorAdjustment: number (double)
  The prior adjustment amount.
• priorDisputes: number (double)
  The prior disputed amount.
• resourceName: string
  The resource name.

{
    "type":"object",
    "description":"Rated details for a non-currency resource.",
    "properties":{
        "originalNetAmount":{
            "type":"number",
            "format":"double",
            "description":"The original net amount."
        },
        "priorAdjustment":{
            "type":"number",
            "format":"double",
            "description":"The prior adjustment amount."
        },
        "priorDisputes":{
            "type":"number",
            "format":"double",
            "description":"The prior disputed amount."
        },
        "resourceName":{
            "type":"string",
            "description":"The resource name."
        }
    }
}

Nested Schema : RatedProductUsage

Type: object

An occurrence of employing a product for its intended purpose with all rating details.

Show Source

• taxCode: string
  The tax code.
• taxExcludedAmount: object Money
  Represents a monetary amount.
• taxIncludedAmount: object Money
  Represents a monetary amount.
• taxRate: number (float)
  The tax rate.

{
    "type":"object",
    "description":"An occurrence of employing a product for its intended purpose with all rating details.",
    "properties":{
        "taxCode":{
            "type":"string",
            "description":"The tax code."
        },
        "taxExcludedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "taxIncludedAmount":{
            "$ref":"#/components/schemas/Money"
        },
        "taxRate":{
            "type":"number",
            "format":"float",
            "description":"The tax rate."
        }
    }
}

400 Response

The request is invalid.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

401 Response

The request is unauthorized.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

403 Response

The request is forbidden.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

404 Response

The resource was not found.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

405 Response

The request method is not allowed.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

409 Response

The request conflicts with the current state of the resource.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

500 Response

The server encountered an internal error.

Body ()

Root Schema : Error

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Match All

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code.

Show Source

• object Extensible
  Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
• object Error-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Extensible"
        },
        {
            "type":"object",
            "required":[
                "code",
                "reason"
            ],
            "properties":{
                "code":{
                    "type":"string",
                    "description":"The application-specific error detail defined by the API or a common list."
                },
                "reason":{
                    "type":"string",
                    "description":"Explains the error to a client user."
                },
                "message":{
                    "type":"string",
                    "description":"Provides error details and corrective actions for a client user."
                },
                "status":{
                    "type":"string",
                    "description":"The HTTP error code extension."
                },
                "referenceError":{
                    "type":"string",
                    "description":"The URI of documentation that describes the error."
                }
            }
        }
    ],
    "description":"Represents an error returned by an API, typically with an HTTP 3xx, 4xx, or 5xx response code."
}

Nested Schema : Extensible

Type: object

Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.

Show Source

• @baseType: string
  The superclass.
• @schemaLocation: string
  The URI of a JSON Schema file that defines additional attributes and relationships.
• @type(required): string
  The subclass Extensible name.

{
    "type":"object",
    "description":"Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.",
    "properties":{
        "@type":{
            "type":"string",
            "nullable":true,
            "description":"The subclass Extensible name."
        },
        "@baseType":{
            "type":"string",
            "nullable":true,
            "description":"The superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "nullable":true,
            "description":"The URI of a JSON Schema file that defines additional attributes and relationships."
        }
    },
    "required":[
        "@type"
    ]
}

Nested Schema : Error-allOf[1]

Type: object

Show Source

• code(required): string
  The application-specific error detail defined by the API or a common list.
• message: string
  Provides error details and corrective actions for a client user.
• reason(required): string
  Explains the error to a client user.
• referenceError: string
  The URI of documentation that describes the error.
• status: string
  The HTTP error code extension.

{
    "type":"object",
    "required":[
        "code",
        "reason"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"The application-specific error detail defined by the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explains the error to a client user."
        },
        "message":{
            "type":"string",
            "description":"Provides error details and corrective actions for a client user."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI of documentation that describes the error."
        }
    }
}

Back to Top

Examples

The following example shows how to retrieve a usage record by its event ID using cURL. For more information, see Use cURL.

Get Usage by Event ID

The following example specifies the event ID in the request path.

curl -X GET 'http://host:port/brm/usageManagement/v4/usage/0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+364738793259054626'

Response Body

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

[
  {
    "@type": "Usage",
    "billStructure": {
      "id": "billing-account-strucuture-post-4"
    },
    "description": "Cycle Forward Fees (srvc): Standard GSM Telephony",
    "adjustedAmount": {
      "value": -3,
      "unit": "EUR"
    },
    "endTime": "2026-10-07T07:28:06.00Z",
    "id": "0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+364738793259054626",
    "href": "http://localhost:9090/brm/usageManagement/v5/usage/0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+364738793259054626",
    "taxAmount": {
      "unit": "EUR",
      "value": 0
    },
    "remainingAmount": {
      "unit": "EUR",
      "value": 37.548
    },
    "settledDisputeAmount": {
      "unit": "EUR",
      "value": -3
    },
    "discount": {
      "unit": "EUR",
      "value": 0
    },
    "billingAccount": {
      "id": "0.0.0.1-158699"
    },
    "service": {
      "id": "service-635"
    },
    "usageType": "/event/billing/product/fee/cycle/cycle_forward_monthly",
    "cycleEnd": "2026-11-03T08:00:00.00Z",
    "effectiveDate": "",
    "rumName": "Occurrence",
    "@baseType": "Usage",
    "bill": {
      "id": "0.0.0.1+-bill+364738793259034651"
    },
    "appliedCustomerBillingRate": {
      "id": "0.0.0.1+-item-cycle_forward+364738793259055650"
    },
    "cycleStart": "2026-10-07T07:00:00.00Z",
    "quantity": 1,
    "@SchemaLocation": "",
    "ratedProductUsage": [
      {
        "taxIncludedAmount": {
          "unit": "EUR",
          "value": 43.548
        },
        "taxExcludedAmount": {
          "unit": "EUR",
          "value": 43.548
        },
        "taxCode": "VAT",
        "taxRate": 0
      }
    ],
    "nonCurrencyDetails": [
      {
        "resourceName": "YES",
        "priorAdjustment": -0.2,
        "originalNetAmount": -3135.5
      }
    ],
    "usageDate": "2026-10-07T07:28:06.00Z"
  }
]

Back to Top