Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!

 

Home > Aria6 core api > get_usage_summary_by_type

get_usage_summary_by_type

Returns the usage records associated with a specified account for a particular date range.

Input Arguments

Req Field Name Field Type Max Length Description
client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
acct_no long 22 Aria-assigned account identifier. This value is unique across all Aria managed accounts.
OR
user_id string 32 Account's user ID. Alternative to using acct_no.
usage_type_filter long 8 The Aria-assigned usage type number used to search for usage history records.
OR
usage_type_cd_filter string 100 The client assigned usage type code used to search for usage history records.
date_filter_start_date string 14 Specifies the start-date of the given date range. The date is in the format yyyy-mm-dd.
date_filter_start_time string 14 Specifies the start-time of the given time range. The time is in the format hh24:mi:ss.
date_filter_end_date string 14 Specifies the end-date of the given date range. The date is in the format yyyy-mm-dd.
date_filter_end_time string 14 Specifies the start-time of the given time range. The time is in the format hh24:mi:ss.
billed_filter long 1 Specifies billed records or unbilled records   Allowable Values
billing_period_flag long 1 Specifies whether to select records of current billing cycle   Allowable Values
usage_qualifier_1 string array 1000 Optional list of filters to apply against usage qualifier number 1, stored in the Aria system
usage_qualifier_2 string array 1000 Optional list of filters to apply against usage qualifier number 2, stored in the Aria system
usage_qualifier_3 string array 1000 Optional list of filters to apply against usage qualifier number 3, stored in the Aria system
usage_qualifier_4 string array Optional list of filters to apply against usage qualifier number 4, stored in the Aria system
retrieve_excluded_usage string 8 Use this field to include usage records that have been permanently excluded from billing   Allowable Values
alt_caller_id string 30 Person or process that submitted the API call. This can be someone's user ID, or the name of an application.
optional_transaction_qualifiers array Array of additional values you can associate with this API call.
qualifier_name string 100 Name of the field you want to associate with this API call.
qualifier_value string 100 Corresponding value of the field you want to associate with this API call.

Output Arguments

Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.
start_date string The start-date of the given date range
start_time string The start-time of the given time range
end_date string The end-date of the given date range
end_time string The end-time of the given time range
usage_summary_records hash Usage summary records of the account (and optional specified usage type) for given date range
usage_type_no long Aria-assigned unique identifier representing the type of usage that is being recorded.
usage_type_label string Aria-assigned the label to representing the usage type
billed_ind long Specifies billed records or unbilled records
total_units double The total number of usage units
total_value_amount double The total amount of the usage
total_value_currency_code string The currency code for the usage
last_usage_date string The last date when usage is loaded
usage_type_cd string An array containing usage_type_cd(s) to denote which usage type(s) to record.

You must to post a comment.
Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.