---
title: "Account history record search"
method: GET
path: "/v2/partition/{partitionId}/account/{accountId}/accounthistorysearch"
tags: ["Account"]
---

# Account history record search

`GET /v2/partition/{partitionId}/account/{accountId}/accounthistorysearch`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/accounthistorysearch`
- Auth: API key in header `X-AUTH-TOKEN`

Account history records can be queried to find out what happened to an account, at what time, and by whom.  Account history includes more than just fields directly on account.  <span hidden>see also <a href ="accountHistory.html">here</a></span>

## Path parameters

- `accountId` string, required
- `partitionId` string, required

## Query parameters

- `accountHistoryType` string[]
- `endDate` string, date
- `firstResultIndex` integer
- `maxResult` integer
- `startDate` string, date

## Response `200`

Successful operation

- AccountHistorySearchResponseX
  - `totalRecords` integer
  - `accountCreatedDate` string, date-time
  - `accountLastUpdatedDate` string, date-time
  - `results` AccountHistoryX[]
    - `id` string
    - `accountId` string
    - `accountNumber` string
    - `oldValue` string
    - `newValue` string
    - `userName` string
    - `userId` string
    - `userType` 'AccountUser' | 'EndUser' | 'ManagementUser' | 'AlianzaUser' | 'BusinessLines'
    - `partitionName` string
    - `accountHistoryType` 'PHONE_NUMBER' | 'PROVISIONING' | 'CALL_FORWARDING' | 'CALL_SCREENING' | 'ADDRESS' | 'ADDRESS_CSR' | 'ADDRESS_E911' | 'ADDRESS_DIRECTORY_LISTING' | 'ACCOUNT_STATUS' | 'VOICEMAIL' | 'CALLING_PLAN' | 'INBOUND_CALLING_PLAN' | 'IVR' | 'SIP_TRUNK' | 'SIP_TRUNK_FORWARD' | 'SIP_TRUNK_GROUP' | 'DEVICE' | 'DEVICE_METADATA' | 'USER' | 'USER_API_AUTH' | 'LINE_HUNTGROUP' | 'ACCOUNT' | 'LINE_APPEARANCE' | 'LINE_HARDWARE' | 'VFAX' | 'PAGING_GROUP' | 'PICKUP_GROUP' | 'GROUP_OF_REFERENCES' | 'CALL_PARKING_SPOT' | 'ACCOUNT_USER' | 'SIP_CREDENTIALS' | 'BUSINESS_LINE' | 'BUSINESS_LINE_HUNT_GROUP' | 'CALL_GROUP' | 'CALL_QUEUE' | 'USER_DEVICE_LINE' | 'EMERGENCY_NOTIFICATION' | 'DYNAMIC_RESERVATION' | 'SPECIALTY_LINE' | 'AUTHORITY' | 'AUTO_ATTENDANT' | 'CONTACT' | 'CONTACT_CENTER' | 'CALL_RECORDING' | 'ACCOUNT_CODE' | 'SHORT_CODE' | 'MEDIA_MANAGEMENT' | 'SOUNDS' | 'USER_GROUP'
    - `loggedDate` string, date-time
    - `referenceType` 'Account' | 'LineAppearance' | 'LineHuntGroup' | 'SipTrunk' | 'SipTrunkForward' | 'Device' | 'Telephone' | 'IVR' | 'EndUser' | 'VFax' | 'VoicemailBox' | 'PagingGroup' | 'GroupOfReferences' | 'PickupGroup' | 'CallParkingSpot' | 'AccountUser' | 'SIP_CREDENTIALS' | 'BUSINESS_LINE' | 'BUSINESS_LINE_HUNT_GROUP' | 'CALL_GROUP' | 'CALL_QUEUE' | 'USER_DEVICE_LINE' | 'SIP_TRUNK' | 'SIP_TRUNK_GROUP' | 'EMERGENCY_NOTIFICATION_COMPLIANCE' | 'DYNAMIC_RESERVATION' | 'SPECIALTY_LINE' | 'AUTHORITY_ROLE' | 'AUTO_ATTENDANT' | 'END_USER_CONTACT' | 'CUSTOM_CONTACT' | 'CONTACT_CENTER' | 'CALL_RECORDING' | 'ACCOUNT_CODE' | 'SHORT_CODE' | 'MEDIA_MANAGEMENT' | 'SOUNDS' | 'USER_GROUP' | 'USER_API_AUTH'
    - `referenceId` string
    - `referenceName` string
    - `action` 'CREATE' | 'UPDATE' | 'PROVISION_REQUEST' | 'DELETE'

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/cb514a0728ed?raw)