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. |
![]() |
query_string | string | 1000 | The criteria which all returned objects must match. Different objects have a different set of searchable criteria.Fields marked with "*Query" in the returns section can be used as part of the query_string. Valid operations for the query string include "=", "!=", "<", "<=", ">=", ">", "IS NULL", "IS NOT NULL", "LIKE", and "NOT LIKE". You must leave a space before and after each operation. The first operand must always be a field name, and the second operand must always be a value (except for "IS NULL" and "IS NOT NULL", where the second operand is implicitly "NULL"). If the second operand contains a space, less than, greater than, or equals sign, then it must be enclosed in double quotes. The second operand may not contain double quotes. Multiple conditions must be joined with either "AND" or "OR". Additionally, any queryable field can also be used to order the results, by appending "ORDER BY" to the query, followed by a field name and either "ASC" or "DESC". |
username | string | 30 | DeprecatedThe login name of the user making this request. It is the same name that is used to log in to the Aria Administration and Configuration Tool. | |
password | string | 1000 | DeprecatedThe password of the user making this request. It is the same password that is used to log in to the Aria Administration and Configuration Tool. | |
limit | long | 12 | The maximum number of objects to be returned by this call. Note that Aria recommends a maximum limit of less than 1,000. Higher limits may take much longer to return data. If you do not specify a value, or specify a value of "0", this field defaults to 100. Specifying a value of "-1" returns a count of the number of matching records, but does not return any records. | |
offset | long | 12 | The number of records to skip. Note that both "0" and NULL will cause the interface not to skip any records. |
Key Name | Description | ||||||
---|---|---|---|---|---|---|---|
acct_no | The Aria assigned ID of the account | ||||||
client_acct_id | Client specified account identifier | ||||||
user_id | The client defined user_id for the account | ||||||
first_name | Account holder's first name | ||||||
last_name | Account holder's last name | ||||||
company_name | Account holder's company name | ||||||
city | Account holder's city | ||||||
country_cd | Account holder's ISO-compliant, 2-character country code abbreviation in uppercase | ||||||
postal_cd | Account holder's postal code | ||||||
senior_acct_no | The Aria assigned ID of the parent account, if any. | ||||||
acct_supp_field_name | Pipe-delimited array of supplemental field names | ||||||
acct_supp_field_value | Pipe-delimited array of supplemental field values | ||||||
billing_group_no | The system defined billing group ID | ||||||
client_billing_group_id | The client defined defined billing group ID | ||||||
primary_pay_method | Primary pay method number | ||||||
secondary_pay_method | Secondary pay method number | ||||||
client_master_plan_id (deprecated) | Client-defined unique identifier for a Master Plan | ||||||
po_num | Purchase order number assigned to the account or Plan instance | ||||||
client_supp_plan_id | Client-defined identifier for a Supplemental Plan | ||||||
supp_plan_no | Aria-assigned identifier for a Supplemental Plan | ||||||
consumer_acct_ind | Salesforce-specific indicator that identifies an account as a consumer account or a business account
|
||||||
Email address on account | |||||||
bill_email | Email address on the account’s associated billing group |
Field Name | Field Type | Description | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error_code | long | Aria-assigned error identifier. 0 indicates no error | ||||||||||||||||||||||||||||||||||||||
error_msg | string | Textual description of any error that occurred. "OK" if there was no error | ||||||||||||||||||||||||||||||||||||||
starting_record | long | This indicates the number of objects that were (or would be) skipped before beginning output | ||||||||||||||||||||||||||||||||||||||
total_records | long | This is the total number of objects that matched the provided criteria | ||||||||||||||||||||||||||||||||||||||
account_details_m | hash | Detailed information about any accounts matching the query | ||||||||||||||||||||||||||||||||||||||
![]() |
long | The Aria assigned ID of the account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client specified account identifier | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The client defined user_id for the account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's first name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's middle initial | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's last name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's company name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | First address line of the account holder | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Second address line of the account holder | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Third address line of the account holder | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's city | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's locality | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's state or province name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's state or province code | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's ISO-compliant, 2-character country code abbreviation | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's postal code | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's phone number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's phone extension | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's cell phone number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's work phone number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's work phone extension | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's fax number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's email address | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's date of birth | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The status code of the account. See the Aria Account Services API documentation for details | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
How the client communicates with the account holder Allowable Values For notify_method
|
||||||||||||||||||||||||||||||||||||||
![]() |
long | The Aria assigned ID of the parent account, if any. | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The user_id of the parent account, if any. | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The client specified account identifier of the parent account, if any. | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
Indicates whether the account is a test account and is treated as such in the system. Allowable Values For test_acct_id
|
||||||||||||||||||||||||||||||||||||||
![]() |
string | Account holder's taxpayer identification number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Date, in yyyy-mm-dd format, on which the account was first created outside of Aria | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Email template number assigned to the account | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Functional account group number specifically designated for statement sequence number assignment | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
Tax exemption level for the account. This field only applies to the Aria internal tax engine. Allowable Values For tax_exemption_level
|
||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined email template identifier assigned to the account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The client-defined alternate email template identifier used for the account | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of functional account groups to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Aria-assigned identifier for the functional account group to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for the functional account group to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of collection account groups to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Aria-assigned identifier for the collection account group to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for the collection account group to which the account is assigned | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of supplemental field names associated with an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Array of supplemental field names | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Array of supplemental field values | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of surcharge numbers associated with an account | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Surcharge number associated with an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The 3-character ISO-compliant currency code for monetary values used for an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The balance owed by an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Address verification code for the account contact address | ||||||||||||||||||||||||||||||||||||||
![]() |
long | The match score of the account contact address verification code | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of billing groups to which the account's Master Plan's belong | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The Aria-assigned billing group identifier | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Name of a billing group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Description of a billing group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The client-defined billing group identifier | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
Indicates whether or not the account shall be listed at the start of a master file. Allowable Values For bg_list_start_master_file
|
||||||||||||||||||||||||||||||||||||||
![]() |
long | Primary pay method number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Primary pay method name | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Secondary pay method number | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Secondary pay method name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Comma-delimited list of email addresses to which the account holder's statements are currently cc'd (carbon copied). | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Comma-delimited list of email addresses to which the account holder's statements are currently bcc'd (blind carbon copied). | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Aria-assigned identifier of the collection group assigned to a billing group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier of the collection group assigned to a billing group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Collection group name | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Collection group description | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of Master Plan Instances associated with an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Aria-assigned identifier for a Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for a Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for a Master Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Aria-assigned identifier for a Master Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Description of a Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Aria Internal Id for dunning group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined dunning group id | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Name of the dunning group | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Dunning group description | ||||||||||||||||||||||||||||||||||||||
![]() |
long | The unique identifier of the dunning process | ||||||||||||||||||||||||||||||||||||||
![]() |
string | The client-defined identifier of the dunning process | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of Supplemental Plans assigned to an account | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Aria-assigned identifier for a Supplemental Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for a Supplemental Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for a Supplemental Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Aria-assigned identifier for a Supplemental Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Description of each assigned Supplemental Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Status of each assigned Supplemental Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Aria-assigned identifier for the parent Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-defined identifier for the parent Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Purchase order number assigned to the account or Plan instance | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of the supplemental field names and values associated with the assigned Supplemental Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Supplemental field name associated with the assigned Supplemental Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Supplemental field value associated with the assigned Supplemental Plan | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of coupon codes used by the account holder | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Unique coupon identifier for a coupon | ||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of the supplemental field names and values associated with the assigned Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Supplemental field name associated with the assigned Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Supplemental field value associated with the assigned Master Plan Instance | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
Bill lag days refer to the number of days prior to (negative) or after (positive) an account billing date at which you specified that an invoice should be generated for a Master Plan Instance. Examples:
|
||||||||||||||||||||||||||||||||||||||
![]() |
string |
Salesforce-specific indicator that identifies an account as a consumer account or a business account Allowable Values For consumer_acct_ind
|
||||||||||||||||||||||||||||||||||||||
![]() |
string | Purchase order number assigned to the account or Plan instance. | ||||||||||||||||||||||||||||||||||||||
![]() |
long |
Indicates whether or not the account shall be listed at the start of a master file. Allowable Values For list_start_master_file
|
||||||||||||||||||||||||||||||||||||||
![]() |
hash | List of contact details associated with an account | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria-assigned unique identifiers for all billing contacts that match the contact search criteria entered. The get_acct_contacts_m API can be used to reference contact information for each matching contact. If no contact-specific search criteria was input, then all billing contact ID numbers for the account are displayed. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria-assigned unique identifiers for all statement contacts that match the contact search criteria entered. The get_acct_contacts_m API can be used to reference contact information for each matching contact. If no contact-specific search criteria was input, then all statement contact ID numbers for the account are displayed. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria-assigned unique identifiers for all account contacts that match the contact search criteria entered. The get_acct_contacts_m API can be used to review details for each matching contact. If no contact-specific search criteria was input, then all account contact ID numbers for the account are displayed. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria-assigned unique identifiers for all destination contacts, related to orders, which match the contact search criteria entered. The get_acct_contacts_m API can be used to reference contact information for each matching contact. If no contact-specific search criteria was input, then all destination contact order ID numbers for the account are displayed. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria assigned unique identifiers for all destination contacts, related to services, which match the contact search criteria entered. If no contact-specific search criteria was input, then all destination contact service ID numbers for the account are displayed. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | This output displays all Aria-assigned unique identifiers for all inactive contacts that matched the contact search criteria entered. | ||||||||||||||||||||||||||||||||||||||
![]() |
long | Aria-assigned legal entity identification number. | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-assigned descriptor of the legal entity. | ||||||||||||||||||||||||||||||||||||||
![]() |
string | Client-assigned unique identifier for the legal entity. |