Recurring Expiration Overrides
This documentation defines the Recurring Expiration Overrides (ARSUBEXP) schema fields.
Please Note This documentation defines the most relevant fields. Treat the response from the View Table Schema (
XMGETFMT) endpoint as the authoritative field list for any specific site.
Date formats
NTD is a timestamp format used by DICE. NTD dates are used when defining time frames within endpoint calls. See the Date Format documentation for information on converting NTD to UNIX and vice versa if needed.
Field definitions
| # | Name | Description | Length | Padding Type |
|---|---|---|---|---|
| 1 | AR_NUMBER | The unique accounting identifier assigned to the customer. | 10 | Pad with trailing spaces. |
| 2 | ACCOUNT_NUMBER | The subscriber account number assigned upon creation. | 9 | Right justify data and pad with leading spaces. |
| 3 | BILLING_CODE_LINE | The unique identifier assigned to the line. | 2 | Pad with trailing spaces. |
| 4 | EXPIRATION_DATE | The expiration date based on the contract code term assigned to the recurring line. | 6 | Pad with trailing spaces. |
| 5 | WARRANTY_EXP | The expiration date based on the warranty code term for the recurring line. | 6 | Pad with trailing spaces. |
| 6 | OVERRIDE_EXP_DATE | Determines whether the default expiration date should be overridden by an alternate date. Accepts: Y or N. | 1 | Pad with trailing spaces. |
| 7 | OVERRIDE_WARN_EXP | Determines whether the default warranty expiration date should be overridden by an alternate date. Accepts: Y or N. | 1 | Pad with trailing spaces. |
Example request
curl --request GET \
--url 'https://global-rest.ci.matrixmcloud.com/rest/rest.php?dataSource=dice&*view=arsubexp&*limit=100&*blanks=all' \
--header 'X-DICE-APPKEY: {{X-DICE-APPKEY}}' \
--header 'X-DICE-USERNAME: {{X-DICE-USERNAME}}' \
--header 'X-DICE-DATE: {{X-DICE-DATE}}' \
--header 'X-DICE-NONCE: {{X-DICE-NONCE}}' \
--header 'X-DICE-DIGEST: {{X-DICE-DIGEST}}' \
--header 'Accept: application/json' \
Example response
{
"ARSUBEXP": [
{
"AR_NUMBER": "000180",
"ACCOUNT_NUMBER": " 010754",
"BILLING_CODE_LINE": " !",
"EXPIRATION_DATE": "04/30/25",
"WARRANTY_EXP": "01/01/18",
"OVERRIDE_EXP_DATE": "",
"OVERRIDE_WARN_EXP": ""
}
],
"totalRecords": 1
}