ALalianza
Account

Retrieve account by an ID.

Though the accountId may be used to retrieve the account, it is not the only unique identifier for an account. Valid IDs are Id (accountId), AccountNumber, PhoneNumber, and MacAddress. Use the 'accountIdType' query parameter designate the ID type.

get/v2/partition/{partitionId}/account/{accountId}

Request

Path parameters

accountIdstring required

ID of account

partitionIdstring required

ID of partition

Query parameters

accountIdType'Id' | 'AccountNumber' | 'PhoneNumber' | 'MacAddress'

Indicates what kind of value has been put in the accountId path parameter. Default is Id.

Response

Successful operation

idstring required

Required to update an account, not required for new account

partitionIdstring required

A partitionId identifies the business entity that this account is a part of. Refers to <a href="#/~schema/PartitionX">partition.id</a>

accountNumberstring required

The accountNumber is a string that uniquely identifies the account within a partition. AccountNumbers can be used to search for an account.

accountNamestring required

The account name is a string that describes the account. The accountName is a field that can be used to identify the account in a search, though it is not required to be unique.

billingCycleDayinteger required

The day that marks the start of a billing cycle. Must be between 1 and 28.

customFieldstring

Can be used to store generic data for the account.

status'ACTIVE' | 'DISABLED' | 'DELETED' | 'DELETE_PENDING' | 'SUSPENDED' | 'PENDING' required

The status of the account within Alianza's system. Must be one of [ACTIVE,DISABLED,DELETED,DELETE_PENDING,SUSPENDED,PENDING]

timeZone'US/Samoa' | 'US/Hawaii' | 'US/Alaska' | 'US/Pacific' | 'US/Arizona' | 'US/Mountain' | 'US/Central' | 'US/Eastern' | 'America/St_Thomas' | 'Canada/Pacific' | 'Canada/Mountain' | 'Canada/Central' | 'Canada/Eastern' | 'Canada/Atlantic' | 'Canada/Newfoundland' required

The IANA Time Zone Database (TZDB) zone id for the account. Must be a timezone for an area within Alianza's supported regions.

languageTagstring
deletionDatestring date-time

ISO 8601 formatted date string of when the account was deleted. This is a deprecated field as deleted accounts are no longer retained. This field is present for backwards compatibility with old data.

accountType'SIMPLE' | 'ADVANCED' required

The account type indicates whether the account supports only a single user (SIMPLE) or multiple users (ADVANCED).

platformType'V2_0' | 'V2_1' | 'CPE1' | 'CPE2'

The platform type indicates the features that are supported for the account. CPE1 supports the basic telephone features while CPE2 supports the business cloud communication features. PlatformTypes of V1_0 and V2_0 are deprecated and only present for backwards compatibility.

platformChangeDatestring date-time
inboundRatePlanProductIdstring

Identifies the inbound rate plan product for the account. This plan controls how toll free numbers are handled in the account. This field is only required for accounts with toll-free numbers.

extensionLengthinteger required

Length of extension, not required for accounts with a SIMPLE accountType.

dialingBehaviorType'SEVEN_DIGIT' | 'TEN_DIGIT' | 'OPEN_DIAL_PLAN' | 'DIAL_NINE_SEVEN_DIGIT' | 'DIAL_NINE_TEN_DIGIT' | 'OPEN_DIAL_PLAN_TEN_DIGIT' required

Defines how a user would be required to dial in order to place a call. For example, being required to dial 9 before placing a call.

routePlanIdstring uuid

UUID of the route plan for this account. Route plans determine where outbound calls are routed and are created for a partition by Alianza. The routePlanId must be one that is available on the account's partition. All users on an account will share the same outbound route plan.

holdMusicMediaIdstring

Id of the music file to be played when an inbound call is placed on hold.

holdTimeoutSecondsinteger

Time in seconds before a call that has been placed on hold will be terminated. Does not apply to CPE1 platformTypes.

allowDangerousExtensionsboolean

Allows extensions starting with 1

domainstring

Overrides the partition default branding which is used in the display of end user emails and the end user portal.

sendWelcomeEmailboolean

Specifies if new users added to the account will receive a welcome email.

regulatoryType'RESIDENTIAL' | 'COMMERCIAL' | 'GOVERNMENT' required
endUserCountinteger

Indicates the number of end users associated with this account.

customHoldMusicMediaIdstring

Changes

No recorded changes to this operation across all 1 revision of this API.