Skip to main content
Aria Knowledge Central

get_all_acct_contracts_m Guide

The get_all_acct_contracts_m API returns an array of contracts associated with the given account, as well as contract details. You can optionally filter by contract status.

API Specification: get_all_acct_contracts_m
Required Fields:
  • <client_no>
  • <auth_key>
  • <account_no> or <client_acct_id>

Additional Guidance

Input Fields
Field Name Notes
<contract_limit>

The contracts will be returned in ascending order by <contract_no>.

Example: You have an account that has 4 contracts numbered: 123, 234, 456, and 567. If you pass 2 into this field, only contracts 123 and 234 will be returned.

If you don't pass a value into this field, then all contracts that match your input values will be returned.

Note: For better performance, it is recommended that you pass 50 into the <contract_limit> filed.

<contract_offset>

Specifies the number of contracts to skip.

The contracts will be skipped in ascending order by <contract_no>.

Example: You have an account that has 4 contracts numbered: 123, 234, 456, and 567. If you pass 2 into this field, only contracts 456 and 567 will be returned.

If you don't pass a value into this field, then it will default to 0.

<filter_status_code>
Allowable values for filter_status_code:
Values Description
0 Inactive
1 Active
  Do not filter by status (default)
<exclude_terminated_plan_inst>
Allowable values for exclude_terminated_plan_inst:
Values Description
false Plan instances with Terminated status will be returned. (default)
true No plan instances with Terminated status will be returned.
<include_contract_billing_installment>
Allowable values for include_contract_billing_installment:
Values Description
0 do not return contract billing values(default)
1 return contract billing values
Output Fields
Field Name Notes
<type_no>
Allowable values
Values Description
2 Continue existing service without contract
3 Renew existing contract automatically
6 Terminate service and billing
7 Terminate service and billing and prorate final invoice
8 Rollover to a different plan/rate/custom rates (applicable only for multi-plan contracts)
<status_code>
Allowable values
Values Description
-3 Contract no longer in scope, usually due to mid-contract plan change on account.
-2 Terminated. Contract cancelled by client or system.
-1 Cancelled. Contract cancelled by end user.
0 Contract completed and renewed. New contract record refers to this contract record.
1 In Effect. Contract is currently active.
99 Completed. Contract is completed, no renewal.
<plan_instance_status_cd>
Allowable values
Values Description
1 Active
2 Pending Cancellation
3 Pending Termination
31 Pending Installation
32 Pending Activation
41 Trial
61 Active Non-billable
0 Inactive
-1 Suspended
-2 Cancelled
-3 Terminated
<renewal_duration_type>

Indicates whether the contract renewal duration in length is based on months, weeks or days.

Allowable Values
Values Description
1 Days
2 Weeks
3 Months
<duration_type>

Indicates whether the contract renewal duration in length is based on months, weeks or days.

Allowable Values
Values Description
1 Days
2 Weeks
3 Months

Error Codes

Error Code/Description Associated Inputs

1001: unexpected error

 

1004: authentication error

<auth_key>, <client_no>

1009: account does not exist, Account not found: AriaNo (acct_no), Account not found: Userid (userid), or Account not found: ClientId (client_acct_id)

<acct_no>, <client_acct_id>

16001: contract does not exist

<contract_no>, <client_contract_id>

16004: Invalid Filter_Status_Code.  The Filter_Status_Code must be 0=Inactive, 1=Active or Blank/Null=(Default value for both Active and Inactive)

<filter_status_code>

1033:  a parameter that represents a true or false value contains invalid input

<exclude_terminated_plan_inst>

1066: Locale name does not exist in the system.

<locale_name>

1067: Locale no does not exist in the system.

<locale_name>

5067: limit must be between 1 and 999.

<contract_limit>

5068: offset must be greater than or equal to zero.

<contract_offset>
  • Was this article helpful?