---
title: "Get place audit history"
method: GET
path: "/places/v1/{place_handle}/history"
tags: ["Places"]
---

# Get place audit history

`GET /places/v1/{place_handle}/history`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/places/v1/{place_handle}/history`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/places/v1/:place_handle/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve audit history for a place showing all changes over time with pagination. Use the field_name parameter to filter history to only show changes for a specific field.

## Path parameters

- `place_handle` string, required

## Query parameters

- `pagination_token` string, nullable
- `limit` integer, nullable
- `field_name` 'place_handle' | 'name' | 'geofence' | 'metadata' | 'parkings' | 'checkins' | 'timings' | 'closed_on' | 'expected_service_time' | 'locked_from_suggestions' | 'null', nullable

## Response `200`

Successful response

- PlaceHistoryResponse
  - `place_id` string, uuid, required: ID of the place
  - `place_handle` string, required: Handle of the place
  - `history` PlaceHistoryEntry[], required: List of audit history entries
    - `audit_id` string, uuid, required: Unique identifier for this audit entry
    - `changed_at` string, required: Timestamp when the change occurred
    - `changed_by` union: Source information of who made the change
      - Source
        - `source` string, nullable: Source of the request
        - `timestamp` string, nullable: Time when request was made
        - `ip-address` string, nullable: IP address of source
        - `device_id` string, nullable: Id of the device that made the request
        - `driver_handle` string, nullable: Id of the driver who made the request
        - `user_id` string, nullable: Id of the user who made the request
        - `email` string, nullable: Email of the user who made the request
      - unknown
    - `operation` string, required: Type of operation: INSERT, UPDATE, DELETE
    - `changes` object, required: Field-level changes with old and new values
  - `pagination_token` string, nullable: Identifier used to fetch the next page

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `404`: Not found

---

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