> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve signature audit trail

> Returns every signature audit record for a document, oldest first, including those superseded by a later version.

Each record carries the signer's identity, the IP address and user agent captured at signing, the server-clock timestamp, and the content hashes used to verify the document has not changed since.

Records that hashed the document's variable values also report `valuesChanged`: whether those values, as resolved now, differ from when it was signed — and `valuesCompletedLater` when the only difference is details other recipients of the same signature request filled in afterwards.

Records are never removed.

Requires read access to the document.



## OpenAPI

````yaml get /signature/{documentId}/audit
openapi: 3.1.0
info:
  title: HERO API
  version: current
  description: |-
    The HERO REST API.

    See https://developers.myhero.so for the rendered docs.
servers:
  - url: https://app.myhero.so
security: []
paths:
  /signature/{documentId}/audit:
    get:
      tags:
        - Signatures
      summary: Retrieve signature audit trail
      description: >-
        Returns every signature audit record for a document, oldest first,
        including those superseded by a later version.


        Each record carries the signer's identity, the IP address and user agent
        captured at signing, the server-clock timestamp, and the content hashes
        used to verify the document has not changed since.


        Records that hashed the document's variable values also report
        `valuesChanged`: whether those values, as resolved now, differ from when
        it was signed — and `valuesCompletedLater` when the only difference is
        details other recipients of the same signature request filled in
        afterwards.


        Records are never removed.


        Requires read access to the document.
      operationId: getDocumentSignatureAudit
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: documentId
          in: path
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        documentId:
                          type: string
                        nodeId:
                          type: string
                        signer:
                          type: object
                          properties:
                            userId:
                              type: string
                            email:
                              type: string
                            displayName:
                              type: string
                            authProvider:
                              type: string
                          required:
                            - userId
                            - email
                            - displayName
                            - authProvider
                        signatory:
                          type: object
                          properties:
                            name:
                              type: string
                            company:
                              type: string
                            title:
                              type: string
                          required:
                            - name
                        terms:
                          type: string
                        termsHash:
                          type: string
                        ipAddress:
                          type: string
                        userAgent:
                          type: string
                        signedAt:
                          type: number
                        clientReportedAt:
                          type: number
                        hashAlgorithm:
                          type: string
                          enum:
                            - sha256
                        contentHash:
                          type: string
                        resolvedContentHash:
                          type: string
                        documentHash:
                          type: string
                        valuesHash:
                          type: string
                        valuesChanged:
                          type: boolean
                        valuesCompletedLater:
                          type: boolean
                        previousAuditId:
                          type:
                            - string
                            - 'null'
                        chainHash:
                          type: string
                        voidedAt:
                          type: number
                        voidedBy:
                          type: string
                        restoredAt:
                          type: number
                      required:
                        - _id
                        - documentId
                        - nodeId
                        - signer
                        - signatory
                        - terms
                        - termsHash
                        - ipAddress
                        - userAgent
                        - signedAt
                        - hashAlgorithm
                        - contentHash
                        - documentHash
                        - previousAuditId
                        - chainHash
                required:
                  - data
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: HERO personal access token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.