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

# Account history record search

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

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/accounthistorysearch`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/partition/:partitionId/account/accounthistorysearch/get.ts> (a function with typed inputs; its response is checked against the schema)

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

- `partitionId` string, required

## Query parameters

- `accountHistoryType` string[]
- `accountNumber` string, required
- `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)