Contacts History

GET

/v1/contacts/{{contactId}}/history

Returns an audit trail of every field change made to a contact. Every "old value → new value" event tracked when name, email, company, position, or a custom property changes.

creatorId is null when the change came from an automated/service-account flow (e.g. ServiceAccountSendText never sets a user ID) rather than a human user action.

Only changes where oldValue != newValue are ever recorded setting a property to the same value it already had produces no history entry.

Request

Query Params

Responses

🟢200OK

application/json

Paged list of change events for this contact.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://api.voxa.sa/v1/contacts/{{contactId}}/history?skipCount=0&maxResultCount=50'

Response Example

{
    "totalCount": 9,
    "items": [
        {
            "id": "464c3a...............",
            "propertyName": "Name",
            "oldValue": "Noshy",
            "newValue": "Ahmed Noshy",
            "creationTime": "2026-06-19T14:21:51.848968",
            "creatorId": null
        },
        {
            "id": "9673c8...............",
            "propertyName": "Position",
            "oldValue": null,
            "newValue": "Product Engineer",
            "creationTime": "2026-06-19T14:21:21.305314",
            "creatorId": null
        },
        {
            "id": "1341d4...............",
            "propertyName": "Email",
            "oldValue": "ahmed@example.com",
            "newValue": "Noshy@hatif.io",
            "creationTime": "2026-06-19T14:21:21.305153",
            "creatorId": null
        },
        {
            "id": "8b642a...............",
            "propertyName": "Name",
            "oldValue": "Ahmed Al-Otaibi",
            "newValue": "Noshy Al-Otaibi",
            "creationTime": "2026-06-19T14:21:21.30512",
            "creatorId": null
        },
        {
            "id": "838709...............",
            "propertyName": "Company",
            "oldValue": null,
            "newValue": "Acme Co",
            "creationTime": "2026-06-19T13:55:18.29894",
            "creatorId": null
        },
        {
            "id": "4a11d2...............",
            "propertyName": "Email",
            "oldValue": null,
            "newValue": "ahmed@example.com",
            "creationTime": "2026-06-19T13:55:18.298631",
            "creatorId": null
        },
        {
            "id": "6e568a...............",
            "propertyName": "Name",
            "oldValue": "+966501234567",
            "newValue": "Ahmed Al-Otaibi",
            "creationTime": "2026-06-19T13:55:18.298577",
            "creatorId": null
        }
    ]
}

Modified at 2026-06-19 19:34:50

Create Bulk Contacts vCards

List Contact Properties