Subscription usage billing
Unique code which represents a subscription
The IntervalStart date in YYY-MM-DD HH:MM:SS format to filter by
The IntervalEnd date in YYY-MM-DD HH:MM:SS format to filter by
The page to be returned
The number of results per page. [MAX 100]
The additional price option code to filter by.
The renewal order unique identifier.
The filtered usages
There has been a client error. The "message" can be on of the following:
- If the Page parameter is invalid:"The Page parameter must be a positive integer higher than or equal to 1.";
- If the Limit parameter is invalid:"The Limit parameter must be a positive integer lower than 100";
- If IntervalStart or IntervalEnd parameters are not proided together:"Both 'IntervalStart' and 'IntervalEnd' parameters must be provided";
- if the RenewalOrderReference parameter is invalid:"If provided, 'RenewalOrderReference' must be a positive integer.";
- If IntervalStart does not respect the required date format:"'IntervalStart' must be provided in the following format:YYYY-MM-DD HH:MM:SS";
- If Intervalend does not respect the required date format:"'IntervalEnd' must be provided in the following format:YYYY-MM-DD HH:MM:SS";
- If the provided usage start date is earlier than the subscription start date or the provided usage end date is higher than the subscription expiration date"Usage interval out of bounds".
Filter usages client error
Filter usage server error
Unique code which represents a subscription
The price option group code
scaleThe date the usage came in effect.
2018-09-03 17:28:32The date the usage was stopped being used.
2018-09-03 17:28:3215Subscription usage for SeptemberThe saved usages
The unique usage identifier
123459876The subscription code
83FE4FEF2The price option group code
scaleThe date the usage came in effect.
2018-09-03 17:28:32The date the usage was stopped being used.
2018-09-03 17:28:3215Subscription usage for SeptemberThere has been a client error. The "message" in the sample below can be on of the following:
- If mandatory parameters are missing:"Usage was not added as one or more of the mandatory parameters are missing";
- If parameters do not math the required format:"Usage was not added as one or more of the parameters do not match the required format";
- If the subscription does not belong to this account:"Usage was not added as the license code provided is invalid";
- If the provided option code does not belong to the subscription products:"Usage was not added as the option code provided is invalid";
- If the usage intervals for the provided usages overlap between themselves or existing usages:"Usage was not added as the usage interval provided overlaps with an existing usage interval for the same LICENCECODE and OPTIONCODE combination";
- If the provided usage start date is earlier than the subscription start date or the provided usage end date is higher than the subscription expiration date"Usage interval out of bounds".
Not Found
There has been an unexpected server error.
Unique code which represents a subscription
No content
No content
There has been a client error. The "message" can be on of the following:
- If the SubscriptionReference parameter is missing or does not match required type:"One or more parameters lack the required format:SubscriptionReference must be a string.";
- If mandatory parameters are missing:"Please provide at least one of the following parameters:UsageReference, OptionCode, IntervalStart, IntervalEnd";
- If one or more parameters lack the required format:"One or more parameters lack the required format:";
- Usage line already billed:"Usage was not deleted as this usage was already billed.";
- Renewal in progress:"There is a renewal in progress for the provided usage line.";
The "message" can be on of the following:
- When the subscription does not exist or does not belong to this account:"Subscription not found.";
- The usage line does not exist:"Usage line described does not exist";
Delete usages server error
No content
Unique code which represents a subscription
Unique integer which represents a subscription usage
The new units to be updated on the subscription usage.
The new description to be updated on the subscription usage.
The updated usage
The unique usage identifier
123459876The subscription code
83FE4FEF2The price option group code
scaleThe date the usage came in effect.
2018-09-03 17:28:32The date the usage was stopped being used.
2018-09-03 17:28:3215Subscription usage for SeptemberThere has been a client error. The "message" can be on of the following:
- If the SubscriptionReference parameter is missing or does not match required type:"One or more parameters lack the required format:SubscriptionReference must be a string.";
- If mandatory parameters are missing:"Please provide at least one of the following parameters:UsageReference, OptionCode, IntervalStart, IntervalEnd";
- If one or more parameters lack the required format:"One or more parameters lack the required format:";
- Usage line already billed:"Usage was not updated as this usage was already billed.";
- Renewal in progress:"There is a renewal in progress for the provided usage line.";
The "message" can be on of the following:
- When the subscription does not exist or does not belong to this account:"Subscription not found.";
- The usage line does not exist:"Usage line described does not exist";
Update usage server error
Last updated
Was this helpful?